Dir

<br/> >i 本文档的最新修订日期是: > **2020-12-27** # Dir ## 模块简述 获取目录或文件的属性、状态;复制、删除目录或文件。 ## :: State()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Dir</font> :: <font color="#ff6600">State</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 获取文件夹或文件的可读性、可写性、可执行性。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 * **<font color="#ff6600">`path(路径)`</font>** <font color="#0099ff">`(String|Array)`</font> <font color="#BBBBBB">`<必须>`</font>: 需要获取属性的文件夹或文件的路径。 当传入的值为字符串时,则获取对应的文件或文件夹的信息。 亦可以传入多个路径组成的数组,其中数组的键无需定义,值为需要操作的路径。 路径是相对于 <font color="#c7254e">`应用根目录`</font> (即Core、Source文件夹所在的目录,通常是站点根目录)的路径,以 <font color="#c7254e">`/`</font> 开始。 ### 返回 <font color="#0099ff">`(Array)`</font> 类型。 在返回的第一维数组中,键为文件夹或文件的路径,值为数组;在第二维数组中,有以下3个元素: 1. 键为 <font color="#c7254e">`R`</font> ,代表是否可读,当值为 <font color="#c7254e">`Y`</font> 时可读,当值为 <font color="#c7254e">`N`</font> 时不可读; 2. 键为 <font color="#c7254e">`W`</font> ,代表是否可写,当值为 <font color="#c7254e">`Y`</font> 时可写,当值为 <font color="#c7254e">`N`</font> 时不可写; 3. 键为 <font color="#c7254e">`Ex`</font> ,代表是否可执行,当值为 <font color="#c7254e">`Y`</font> 时可执行,当值为 <font color="#c7254e">`N`</font> 时不可执行。 <font color="#c7254e">`文件夹没有此属性`</font> 。 ### 示例 检测核心配置文件Common.php和它的父目录Core是否可读写: ```php $Config=array( 'path'=>array( '/Core', '/Config/Common.php' ) ) $Result=Dir::State($Config); print_r($Result); ``` 执行后的输出为: ```php Array( ['/Core']=>Array( ['R']=>'Y', ['W']=>'Y' ), ['/Config/Common.php']=>Array( ['R']=>'Y', ['W']=>'Y', ['Ex']=>'Y' ) ) ``` >w 本方法不会遍历目录,请指定 <font color="#c7254e">`所有`</font> 需要获取状态的文件夹或文件。 ## :: Size()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Dir</font> :: <font color="#ff6600">Size</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 获取指定目录所包含的所有文件的体积之和。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 * **<font color="#ff6600">`path(路径)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`<必须>`</font>: 指定备份的文件存储到何处,值为相对于 <font color="#c7254e">`应用根目录`</font>(即Core、Source文件夹所在的目录,通常是站点根目录)的路径,以 <font color="#c7254e">`/`</font> 开始。 * **<font color="#ff6600">`unit(单位)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`NULL`</font>: 指定返回体积的计算单位,可传入 <font color="#c7254e">`KB`</font> / <font color="#c7254e">`MB`</font> / <font color="#c7254e">`GB`</font> 。当未传入本参数时,返回体积的计算单位为 <font color="#c7254e">`B`</font>(字节)。 ### 返回 <font color="#0099ff">`(String)`</font> 类型。 根据计算单位(如果已经指定)计算得出的体积大小。 ## :: Delete()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Dir</font> :: <font color="#ff6600">Delete</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 删除指定的目录。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 * **<font color="#ff6600">`path(路径)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`<必须>`</font>: 指定需要操作的文件夹的路径,即相对于 <font color="#c7254e">`应用根目录`</font>(即Core、Source文件夹所在的目录,通常是站点根目录)的路径,以 <font color="#c7254e">`/`</font> 开始。 ### 返回 无。