1 | <?php |
||
12 | class Uploader |
||
13 | { |
||
14 | /** |
||
15 | * Whether to overwrite if there is a file of the same name |
||
16 | * @var boolean |
||
17 | */ |
||
18 | protected $override = false; |
||
19 | |||
20 | /** |
||
21 | * save path |
||
22 | * @var string |
||
23 | */ |
||
24 | protected $savePath = './'; |
||
25 | |||
26 | /** |
||
27 | * Whether to enable random file name |
||
28 | * @var boolean |
||
29 | */ |
||
30 | protected $isRandName = false; |
||
31 | |||
32 | /** |
||
33 | * rules |
||
34 | * @var RuleInterface[] |
||
35 | */ |
||
36 | protected $rules = []; |
||
37 | |||
38 | /** |
||
39 | * file name generator |
||
40 | * @var callable |
||
41 | */ |
||
42 | protected $filenameGenerator; |
||
43 | |||
44 | public function __construct($path = './') |
||
49 | |||
50 | /** |
||
51 | * set override mode |
||
52 | * @param boolean $override |
||
53 | */ |
||
54 | public function setOverride($override) |
||
58 | |||
59 | /** |
||
60 | * get override mode |
||
61 | * @return boolean |
||
62 | */ |
||
63 | public function getOverride() |
||
67 | |||
68 | /** |
||
69 | * set save path |
||
70 | * @param string $path |
||
71 | * @throws UploadException |
||
72 | */ |
||
73 | public function setSavePath($path) |
||
83 | |||
84 | /** |
||
85 | * get save path |
||
86 | * @return string |
||
87 | */ |
||
88 | public function getSavePath() |
||
92 | |||
93 | /** |
||
94 | * set rand name mode |
||
95 | * @param boolean $val |
||
96 | */ |
||
97 | public function setIsRandName($val) |
||
101 | |||
102 | /** |
||
103 | * get rand name mode |
||
104 | * @return boolean |
||
105 | */ |
||
106 | public function getIsRandName() |
||
110 | |||
111 | /** |
||
112 | * set filename generator |
||
113 | * @param callable $generator |
||
114 | */ |
||
115 | public function setFilenameGenerator(callable $generator) |
||
119 | |||
120 | /** |
||
121 | * get current filename generator |
||
122 | * @return string |
||
123 | */ |
||
124 | public function getFilenameGenerator() |
||
132 | |||
133 | /** |
||
134 | * add rule |
||
135 | * @param RuleInterface $rule |
||
136 | */ |
||
137 | public function addRule(RuleInterface $rule) |
||
141 | |||
142 | /** |
||
143 | * gets all rules |
||
144 | * @return array |
||
145 | */ |
||
146 | public function getRules() |
||
150 | |||
151 | /** |
||
152 | * go, process upload |
||
153 | * @param array $files |
||
154 | * @throws UploadException |
||
155 | * @return FileInfo|FileInfo[]; |
||
156 | */ |
||
157 | public function process($files) |
||
180 | |||
181 | /** |
||
182 | * process |
||
183 | * @param array $info |
||
184 | * @return FileInfo; |
||
185 | */ |
||
186 | protected function processUpload(array $info) |
||
201 | |||
202 | /** |
||
203 | * validate rules |
||
204 | * @param FileInfo $file |
||
205 | * @return boolean |
||
206 | */ |
||
207 | protected function validateUpload(FileInfo $file) |
||
218 | |||
219 | /** |
||
220 | * move file |
||
221 | * Illegal upload files and other unsolicited causes can not be moved to throw an exception |
||
222 | * @param FileInfo $file |
||
223 | * @param string $newFilePath |
||
224 | * @return boolean |
||
225 | * @throws UploadException |
||
226 | */ |
||
227 | protected function moveUploadedFile(FileInfo $file, $newFilePath) |
||
244 | |||
245 | /** |
||
246 | * make default rand filename generator |
||
247 | * @return callable |
||
248 | */ |
||
249 | protected function makeDefaultRandFilenameGenerator() |
||
255 | |||
256 | /** |
||
257 | * make default origin filename generator |
||
258 | * @return callable |
||
259 | */ |
||
260 | protected function makeDefaultOriginFilenameGenerator() |
||
266 | |||
267 | /** |
||
268 | * make new filepath |
||
269 | * @param FileInfo $file |
||
270 | * @return string |
||
271 | */ |
||
272 | protected function generateFilename(FileInfo $file) |
||
278 | } |
||
279 |
If you suppress an error, we recommend checking for the error condition explicitly: