## 上传文件
> 内置的上传只是上传到本地服务器，上传到远程或者第三方平台的话需要安装额外的扩展。
假设表单代码如下：
~~~
<form action="/index/upload" enctype="multipart/form-data" method="post">
<input type="file" name="image" /> <br>
<input type="submit" value="上传" />
</form>
~~~
然后在控制器中添加如下的代码：
~~~
public function upload(){
// 获取表单上传文件 例如上传了001.jpg
$file = request()->file('image');
// 上传到本地服务器
$savename = \think\facade\Filesystem::putFile( 'topic', $file);
}
~~~
`$file`变量是一个`\think\File`对象，你可以获取相关的文件信息，支持使用`SplFileObject`类的属性和方法。
## 上传规则
默认情况下是上传到本地服务器，会在`runtime/storage`目录下面生成以当前日期为子目录，以微秒时间的`md5`编码为文件名的文件，例如上面生成的文件名可能是：
~~~
runtime/storage/topic/20160510/42a79759f284b767dfcb2a0197904287.jpg
~~~
如果是多应用的话，上传根目录默认是`runtime/index/storage`，如果你希望上传的文件是可以直接访问或者下载的话，可以使用`public`存储方式。
~~~
$savename = \think\facade\Filesystem::disk('public')->putFile( 'topic', $file);
~~~
你可以在`config/filesystem.php`配置文件中配置上传根目录及上传规则，例如：
~~~
return [
'default' => 'local',
'disks' => [
'local' => [
'type' => 'local',
'root' => app()->getRuntimePath() . 'storage',
],
'public' => [
'type' => 'local',
'root' => app()->getRootPath() . 'public/storage',
'url' => '/storage',
'visibility' => 'public',
],
// 更多的磁盘配置信息
],
];
~~~
我们可以指定上传文件的命名规则，例如：
~~~
$savename = \think\facade\Filesystem::putFile( 'topic', $file, 'md5');
~~~
最终生成的文件名类似于：
~~~
runtime/storage/topic/72/ef580909368d824e899f77c7c98388.jpg
~~~
系统默认提供了几种上传命名规则，包括：
| 规则 | 描述 |
| --- | --- |
| date | 根据日期和微秒数生成 |
| md5 | 对文件使用md5\_file散列生成 |
| sha1 | 对文件使用sha1\_file散列生成 |
> 其中md5和sha1规则会自动以散列值的前两个字符作为子目录，后面的散列值作为文件名。
如果需要使用自定义命名规则，可以在`rule`方法中传入函数或者使用闭包方法，例如：
~~~
$savename = \think\facade\Filesystem::putFile( 'topic', $file,'uniqid');
~~~
如果希望以指定的文件名保存,可调用`putFileAs`方法,例如:
~~~
$savename = \think\facade\Filesystem::putFileAs( 'topic', $file,'abc.jpg');
~~~
## 多文件上传
如果你使用的是多文件上传表单，例如：
~~~
<form action="/index/index/upload" enctype="multipart/form-data" method="post">
<input type="file" name="image[]" /> <br>
<input type="file" name="image[]" /> <br>
<input type="file" name="image[]" /> <br>
<input type="submit" value="上传" />
</form>
~~~
控制器代码可以改成：
~~~
public function upload(){
// 获取表单上传文件
$files = request()->file('image');
$savename = [];
foreach($files as $file){
$savename[] = \think\facade\Filesystem::putFile( 'topic', $file);
}
}
~~~
## 上传验证
支持使用验证类对上传文件的验证，包括文件大小、文件类型和后缀：
~~~
public function upload(){
// 获取表单上传文件
$files = request()->file();
try {
validate(['image'=>'filesize:10240|fileExt:jpg|image:200,200,jpg'])
->check($files);
$savename = [];
foreach($files as $file) {
$savename[] = \think\facade\Filesystem::putFile( 'topic', $file);
}
} catch (\think\exception\ValidateException $e) {
echo $e->getMessage();
}
}
~~~
| 验证参数 | 说明 |
| --- | --- |
| fileSize | 上传文件的最大字节 |
| fileExt | 文件后缀，多个用逗号分割或者数组 |
| fileMime | 文件MIME类型，多个用逗号分割或者数组 |
| image | 验证图像文件的尺寸和类型 |
具体用法可以参考验证器（validate）。
## 获取文件hash散列值
可以获取上传文件的哈希散列值，例如：
~~~
// 获取表单上传文件
$file = request()->file('image');
// 获取上传文件的hash散列值
echo $file->hash('sha1');
echo $file->hash('md5');
~~~
- 搭建ThinkPHP6的开发环境
- 配置ThinkPHP6
- 必要的基础知识（basic）
- MVC开发模式
- 控制器（controller）
- 数据库（database）
- 模型（model）
- 模型关联（relation）
- 视图（view）
- Session
- Cookie
- 缓存（cache）
- 上传（upload）
- 验证器（validate）
- 验证码（captcha）
- 命令行（command）
- 服务器部署（deploy）
- 数据备份（backup）
- 数据同步(synchronization)
- 订阅服务(subscribe)
- PHP 易混淆知识点
- 助手函数
- MySQL规范
- Redis 规范
- office插件 phpoffice
- 拼音插件 pinyin
- 日期插件 datetime
- 消息插件 amqp
- 产品部署环境的搭建
- PDF 等杂项处理
- 文件上传
- 常用扩展
- flc/dysms
- 使用示例 ①
- 使用示例 ②
- qiniu/php-sdk
- 简介
- 使用示例
- 使用示例 2 ②
- liliuwei/thinkphp-jump
- 扩展介绍
- 下载扩展
- 使用方法
- topthink/think-captcha
- 安装扩展
- 验证码显示
- 更换验证码
- 验证码校验
- 验证码配置
- 自定义验证码
- phpoffice/phpspreadsheet
- 数据写入表格
- 读取表格数据
- topthink/think-queue
- 安装
- 自定义函数
- 任务类
- 带有日志的任务类