Joomla3开发教程

JFolder 文件夹操作

Joomla的文件系统提供了对常规文件操作的封装,主要由4个类 JFile,JFolder,JPath,JArchive来实现。本文主要讲解JFolder类的一些常用文件夹操作 

复制文件夹


代码:

JFolder::copy($src, $dest, $path, $force);

这个函数会将$src指定的文件夹及其所有内容(包括子目录)复制到$dest指定的位置。它会检查原地址和目标地址是否存在且权限是否允许。这个方法支持FTP层操作

  • 如果目标路径不存在,则会尝试创建。
  • $path指定相对路径
  • $firce是否覆盖目标文件夹。如果目标路径存在,且$force为false的时候,会提示错误。

创建文件夹


代码:

JFolder::create($path, $mode);

 这个方法是对PHP的mkdir()方法进行封装,在此基础上增加了权限检查和路径可用性检查。这个方法支持FTP层操作。

  • $mode参数可以指定创建文件夹的权限。默认情况下成功创建文件夹后权限会设置为0755
  • 如果父路径不存在,则会尝试创建。如果目录已经存在,则会返回false

移动文件夹


代码:

JFolder::move($src, $dest);

这个方法是对PHP的rename()方法进行封装,在此基础上增加了权限检查和路径可用性检查。这个方法支持FTP层操作。

检查文件夹是否存在


代码:

JFolder::exists($path);

这个函数的实现是对PHP 的is_dir() 函数的封装,如果存在返回true

清理文件夹路径


代码:

JFolder::makeSafe($path);

这个函数会过滤掉文件名中不合法的字符(odd characters),返回一个安全的文件夹名

读取文件夹中的所有文件


代码:

JFolder::files($path, $filter = '.', $recurse, $fullpath , $exclude);

这个函数读取指定文件夹中的所有文件。

  • $path 指定需要读取文件夹的路径
  • $filter 过滤器
  • $recurse 是否递归
  • $fullpath 是否返回全路径
  • $exclude  数组 需要排除的文件扩展名。实际使用中感觉这个参数无效

读取文件夹中的所有文件夹


代码:

JFolder::folders($path, $filter = '.', $recurse, $fullpath , $exclude);

这个函数读取指定文件夹中的所有文件夹。使用方法和JFolder::files一样

得到文件夹数结构


JFolder::listFolderTree($path, $filter, $maxLevel = 3, $level = 0, $parent = 0);

它将读取在$path指定的文件夹,并将结果以数组的方法返回,适合于树形显示。您可以指定级别数。文件夹数组如下所示

Array
(
    [0] => Array
        (
            [id] => 1
            [parent] => 0
            [name] => administrator
            [fullname] => g:/joomla_1012/administrator
            [relname] => g:/joomla_1012/administrator
        )

    [1] => Array
        (
            [id] => 2
            [parent] => 1
            [name] => backups
            [fullname] => g:/joomla_1012/administrator/backups
            [relname] => g:/joomla_1012/administrator/backups
        )

    [2] => Array
        (
            [id] => 3
            [parent] => 1
            [name] => components
            [fullname] => g:/joomla_1012/administrator/components
            [relname] => g:/joomla_1012/administrator/components
        )
)

示范代码


本代码演示了如何使用文件系统来做复制移动操作

目标:

读取根目录下images文件夹的内容。创建一个名为jpg的子文件夹,然后images中所有jpg文件移至jpg子文件夹。

实现代码:

<?php
// First we set up parameters.
$searchpath = JPATH_COMPONENT . '/images';

// Import the folder system library.
jimport('joomla.filesystem.folder');

// Then we create the subfolder called jpg.
if (!JFolder::create($searchpath . "/jpg"))
{
   // Throw error message and stop script.
}

// Now we read all jpg files and put them in an array.
$jpgFiles = JFolder::files($searchpath, '.jpg');

// Now we need some stuff from the ''JFile:: class'' to move all the files into the new folder.
foreach ($jpgFiles as $file)
{
   JFile::move($searchpath . '/' . $file, $searchpath . '/' . 'jpg' . $file);
}

// Last we move the complete subdir to the root of the component.
if (JFolder::move($searchpath . '/'. 'jpg', JPATH_COMPONENT))
{
   // Redirect with perhaps a happy message.
}
else
{
   // Throw an error.
}
?>
 


作者:张敏
原文:http://www.joomlachina.cn/shouce/doc/1916?article_id=1946

获取最新资讯

© 广州市番禺区新造草云信息技术咨询服务部版权所有。
粤ICP备13002429号.

Joomla系列教程

站内链接