[李景山php]每天TP5-20170104|thinkphp5-File.php-1

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2016 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <[email protected]>
// +----------------------------------------------------------------------

namespace think;

use SplFileInfo;// Spl 文件信息 类库
use SplFileObject;// Spl 文件对象 类库
// Spl 一个需要面对的问题

class File extends SplFileObject
{// 文件 继承 SplFileObject 对象
    /**
     * 错误信息
     * @var string
     */
    private $error = ‘‘;// 错误信息存储
    // 当前完整文件名
    protected $filename;// 当前完整的文件名 信息
    // 上传文件名
    protected $saveName;// 上传 文件名
    // 文件上传命名规则
    protected $rule = ‘date‘;// 文件上传的 命名规则
    // 文件上传验证规则
    protected $validate = [];// 文件上传 验证规则
    // 单元测试
    protected $isTest;// 单元测试
    // 上传文件信息
    protected $info;// 上传文件信息
    // 文件hash信息
    protected $hash = [];// 文件 hash 信息

    public function __construct($filename, $mode = ‘r‘)// 结构体
    {
        parent::__construct($filename, $mode);// 函数 构造体 父亲的
        $this->filename = $this->getRealPath();// 获取 文件名称
    }

    /**
     * 是否测试
     * @param  bool   $test 是否测试
     * @return $this
     */
    public function isTest($test = false)
    {
        $this->isTest = $test;// 是否测试信息
        return $this;
    }

    /**
     * 设置上传信息
     * @param  array   $info 上传文件信息
     * @return $this
     */
    public function setUploadInfo($info)
    {
        $this->info = $info;// 设置 上传文件信息
        return $this;
    }

    /**
     * 获取上传文件的信息
     * @param  string   $name
     * @return array|string
     */
    public function getInfo($name = ‘‘)
    {
        return isset($this->info[$name]) ? $this->info[$name] : $this->info;// 获取上传文件信息
    }

    /**
     * 获取上传文件的文件名
     * @return string
     */
    public function getSaveName()
    {
        return $this->saveName;// 获取存储的文件名
    }

    /**
     * 设置上传文件的保存文件名
     * @param  string   $saveName
     * @return $this
     */
    public function setSaveName($saveName)// 设置存储的文件名
    {
        $this->saveName = $saveName;
        return $this;
    }

    /**
     * 获取文件的md5散列值
     * @return $this
     */
    public function md5()// md5 加密文件
    {
        if (!isset($this->hash[‘md5‘])) {
            $this->hash[‘md5‘] = md5_file($this->filename);
        }
        return $this->hash[‘md5‘];
    }

    /**
     * 获取文件的sha1散列值
     * @return $this
     */
    public function sha1()// sha1 文件 散列值
    {
        if (!isset($this->hash[‘sha1‘])) {
            $this->hash[‘sha1‘] = sha1_file($this->filename);
        }
        return $this->hash[‘sha1‘];
    }

    /**
     * 检查目录是否可写
     * @param  string   $path    目录
     * @return boolean
     */
    protected function checkPath($path)//目录 检测
    {
        if (is_dir($path)) {
            return true;
        }

        if (mkdir($path, 0755, true)) {
            return true;
        } else {
            $this->error = "目录 {$path} 创建失败！";
            return false;
        }
    }

    /**
     * 获取文件类型信息
     * @return string
     */
    public function getMime()
    {
        $finfo = finfo_open(FILEINFO_MIME_TYPE);// 获取文件 类型
        return finfo_file($finfo, $this->filename);
    }

    /**
     * 设置文件的命名规则
     * @param  string   $rule    文件命名规则
     * @return $this
     */
    public function rule($rule)
    {// 规则设置
        $this->rule = $rule;
        return $this;
    }

    /**
     * 设置上传文件的验证规则
     * @param  array   $rule    验证规则
     * @return $this
     */
    public function validate($rule = [])
    {// 验证规则
        $this->validate = $rule;
        return $this;
    }

    /**
     * 检测是否合法的上传文件
     * @return bool
     */
    public function isValid()
    {// 检测 文件 是否 合法
        if ($this->isTest) {
            return is_file($this->filename);// 验证是否 为文件
        }
        return is_uploaded_file($this->filename);// 验证 是否 为 上传文件
    }