mirror of
https://github.com/moodle/moodle.git
synced 2025-08-06 01:16:44 +02:00
263 lines
10 KiB
PHP
263 lines
10 KiB
PHP
<?php //$Id$
|
|
|
|
require_once("$CFG->libdir/file/file_info.php");
|
|
require_once("$CFG->libdir/file/file_info_stored.php");
|
|
require_once("$CFG->libdir/file/file_info_system.php");
|
|
require_once("$CFG->libdir/file/file_info_user.php");
|
|
require_once("$CFG->libdir/file/file_info_coursecat.php");
|
|
require_once("$CFG->libdir/file/file_info_course.php");
|
|
require_once("$CFG->libdir/file/file_info_coursefile.php");
|
|
|
|
/**
|
|
* Main interface for browsing of file tree (local files, areas, virtual files, etc.).
|
|
*/
|
|
class file_browser {
|
|
|
|
/**
|
|
* Looks up file_info object
|
|
* @param object $context
|
|
* @param string $filearea
|
|
* @param int $itemid
|
|
* @param string $filepath
|
|
* @param string $filename
|
|
* @return object file_info object or null if not found or access not allowed
|
|
*/
|
|
public function get_file_info($context, $filearea=null, $itemid=null, $filepath=null, $filename=null) {
|
|
global $USER, $CFG, $DB;
|
|
|
|
$fs = get_file_storage();
|
|
|
|
if ($context->contextlevel == CONTEXT_SYSTEM) {
|
|
if (is_null($filearea)) {
|
|
return new file_info_system($this);
|
|
}
|
|
//TODO: question files browsing
|
|
|
|
} else if ($context->contextlevel == CONTEXT_USER) {
|
|
// access control: only own files
|
|
if ($context->instanceid != $USER->id) {
|
|
return null;
|
|
}
|
|
|
|
if (!is_null($filearea) and !in_array($filearea, array('user_private', 'user_draft'))) {
|
|
// file area does not exist, sorry
|
|
return null;
|
|
}
|
|
|
|
if (is_null($filearea)) {
|
|
return new file_info_user($this, $context);
|
|
} else {
|
|
if ($filearea == 'user_private') {
|
|
if (is_null($itemid)) {
|
|
return new file_info_user($this, $context);
|
|
}
|
|
$filepath = is_null($filepath) ? '/' : $filepath;
|
|
$filename = is_null($filename) ? '.' : $filename;
|
|
|
|
if (!$storedfile = $fs->get_file($context->id, $filearea, 0, $filepath, $filename)) {
|
|
if ($filepath === '/' and $filename === '.') {
|
|
$storedfile = $fs->create_directory($context->id, $filearea, 0, $filepath, $USER->id);
|
|
} else {
|
|
// not found
|
|
return null;
|
|
}
|
|
}
|
|
$urlbase = $CFG->wwwroot.'/userfile.php';
|
|
// TODO: localise
|
|
return new file_info_stored($this, $context, $storedfile, $urlbase, 'Personal files', false, true, true);
|
|
|
|
} else if ($filearea == 'user_draft') {
|
|
if (empty($itemid)) {
|
|
return new file_info_user($this, $context);
|
|
}
|
|
$urlbase = $CFG->wwwroot.'/draftfile.php';
|
|
if (!$storedfile = $fs->get_file($context->id, $filearea, $itemid, $filepath, $filename)) {
|
|
return null;
|
|
}
|
|
//something must create the top most directory
|
|
// TODO: localise
|
|
return new file_info_stored($this, $context, $storedfile, $urlbase, 'Draft file area', true, true, true);
|
|
}
|
|
}
|
|
|
|
} else if ($context->contextlevel == CONTEXT_COURSECAT) {
|
|
if (!$category = $DB->get_record('course_categories', array('id'=>$context->instanceid))) {
|
|
return null;
|
|
}
|
|
|
|
if (!$category->visible and !has_capability('moodle/course:viewhiddencourses', $context)) {
|
|
return null;
|
|
}
|
|
|
|
if (!is_null($filearea) and !in_array($filearea, array('coursecat_intro'))) {
|
|
// file area does not exist, sorry
|
|
$filearea = null;
|
|
}
|
|
|
|
if (is_null($filearea) or is_null($itemid)) {
|
|
return new file_info_coursecat($this, $context, $category);
|
|
|
|
} else {
|
|
if ($filearea == 'coursecat_intro') {
|
|
if (!has_capability('moodle/course:update', $context)) {
|
|
return null;
|
|
}
|
|
|
|
$filepath = is_null($filepath) ? '/' : $filepath;
|
|
$filename = is_null($filename) ? '.' : $filename;
|
|
|
|
$urlbase = $CFG->wwwroot.'/pluginfile.php';
|
|
if (!$storedfile = $fs->get_file($context->id, $filearea, 0, $filepath, $filename)) {
|
|
if ($filepath === '/' and $filename === '.') {
|
|
$storedfile = $fs->create_directory($context->id, $filearea, 0, $filepath);
|
|
} else {
|
|
// not found
|
|
return null;
|
|
}
|
|
}
|
|
// TODO: localise
|
|
return new file_info_stored($this, $context, $storedfile, $urlbase, 'Category introduction files', false, true, true);
|
|
|
|
}
|
|
}
|
|
|
|
} else if ($context->contextlevel == CONTEXT_COURSE) {
|
|
if (!$course = $DB->get_record('course', array('id'=>$context->instanceid))) {
|
|
return null;
|
|
}
|
|
|
|
if (!$course->visible and !has_capability('moodle/course:viewhiddencourses', $context)) {
|
|
return null;
|
|
}
|
|
|
|
if (!is_null($filearea) and !in_array($filearea, array('course_intro', 'course_content', 'course_backup'))) {
|
|
// file area does not exist, sorry
|
|
$filearea = null;
|
|
}
|
|
|
|
$filepath = is_null($filepath) ? '/' : $filepath;
|
|
$filename = is_null($filename) ? '.' : $filename;
|
|
|
|
if (is_null($filearea) or is_null($itemid)) {
|
|
return new file_info_course($this, $context, $course);
|
|
|
|
} else {
|
|
if ($filearea === 'course_intro') {
|
|
if (!has_capability('moodle/course:update', $context)) {
|
|
return null;
|
|
}
|
|
|
|
$urlbase = $CFG->wwwroot.'/pluginfile.php';
|
|
if (!$storedfile = $fs->get_file($context->id, $filearea, 0, $filepath, $filename)) {
|
|
if ($filepath === '/' and $filename === '.') {
|
|
$storedfile = $fs->create_directory($context->id, $filearea, 0, $filepath);
|
|
} else {
|
|
// not found
|
|
return null;
|
|
}
|
|
}
|
|
// TODO: localise
|
|
return new file_info_stored($this, $context, $storedfile, $urlbase, 'Course introduction files', false, true, true);
|
|
|
|
} else if ($filearea == 'course_backup') {
|
|
if (!has_capability('moodle/site:backup', $context) and !has_capability('moodle/site:restore', $context)) {
|
|
return null;
|
|
}
|
|
|
|
$urlbase = $CFG->wwwroot.'/pluginfile.php';
|
|
if (!$storedfile = $fs->get_file($context->id, $filearea, 0, $filepath, $filename)) {
|
|
if ($filepath === '/' and $filename === '.') {
|
|
$storedfile = $fs->create_directory($context->id, $filearea, 0, $filepath);
|
|
} else {
|
|
// not found
|
|
return null;
|
|
}
|
|
}
|
|
|
|
$downloadable = has_capability('moodle/site:backupdownload', $context);
|
|
$uploadable = has_capability('moodle/site:backupupload', $context);
|
|
// TODO: localise
|
|
return new file_info_stored($this, $context, $storedfile, $urlbase, 'Backup files', false, $downloadable, $uploadable);
|
|
|
|
} else if ($filearea == 'course_content') {
|
|
if (!has_capability('moodle/course:managefiles', $context)) {
|
|
return null;
|
|
}
|
|
|
|
if (!$storedfile = $fs->get_file($context->id, $filearea, 0, $filepath, $filename)) {
|
|
if ($filepath === '/' and $filename === '.') {
|
|
$storedfile = $fs->create_directory($context->id, $filearea, 0, $filepath);
|
|
} else {
|
|
// not found
|
|
return null;
|
|
}
|
|
}
|
|
|
|
return new file_info_coursefile($this, $context, $storedfile);
|
|
}
|
|
}
|
|
|
|
} else if ($context->contextlevel == CONTEXT_MODULE) {
|
|
//TODO
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Returns content of local directory
|
|
*/
|
|
public function build_stored_file_children($context, $filearea, $itemid, $filepath, $urlbase, $areavisiblename, $itemidused, $readaccess, $writeaccess) {
|
|
$result = array();
|
|
$fs = get_file_storage();
|
|
|
|
$storedfiles = $fs->get_directory_files($context->id, $filearea, $itemid, $filepath, false, true, "filepath, filename");
|
|
foreach ($storedfiles as $file) {
|
|
$result[] = new file_info_stored($this, $context, $file, $urlbase, $areavisiblename, $itemidused, $readaccess, $writeaccess);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Returns content of coursefiles directory
|
|
*/
|
|
public function build_coursefile_children($context, $filepath) {
|
|
$result = array();
|
|
$fs = get_file_storage();
|
|
|
|
$storedfiles = $fs->get_directory_files($context->id, 'course_content', 0, $filepath, false, true, "filepath, filename");
|
|
foreach ($storedfiles as $file) {
|
|
$result[] = new file_info_coursefile($this, $context, $file);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
public function encodepath($urlbase, $path, $forcedownload=false, $https=false) {
|
|
global $CFG;
|
|
|
|
if ($CFG->slasharguments) {
|
|
$parts = explode('/', $path);
|
|
$parts = array_map('rawurlencode', $parts);
|
|
$path = implode('/', $parts);
|
|
$return = $urlbase.$path;
|
|
if ($forcedownload) {
|
|
$return .= '?forcedownload=1';
|
|
}
|
|
} else {
|
|
$path = rawurlencode($path);
|
|
$return = $urlbase.'?file='.$path;
|
|
if ($forcedownload) {
|
|
$return .= '&forcedownload=1';
|
|
}
|
|
}
|
|
|
|
if ($https) {
|
|
$return = str_replace('http://', 'https://', $return);
|
|
}
|
|
|
|
return $return;
|
|
}
|
|
|
|
}
|