]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - actions/restoreaccount.php
Error handling cleanup on backup/restore:
[quix0rs-gnu-social.git] / actions / restoreaccount.php
1 <?php
2 /**
3  * StatusNet - the distributed open-source microblogging tool
4  * Copyright (C) 2010, StatusNet, Inc.
5  *
6  * Restore a backup of your own account from the browser
7  * 
8  * PHP version 5
9  *
10  * This program is free software: you can redistribute it and/or modify
11  * it under the terms of the GNU Affero General Public License as published by
12  * the Free Software Foundation, either version 3 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU Affero General Public License for more details.
19  *
20  * You should have received a copy of the GNU Affero General Public License
21  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
22  *
23  * @category  Account
24  * @package   StatusNet
25  * @author    Evan Prodromou <evan@status.net>
26  * @copyright 2010 StatusNet, Inc.
27  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
28  * @link      http://status.net/
29  */
30
31 if (!defined('STATUSNET')) {
32     // This check helps protect against security problems;
33     // your code file can't be executed directly from the web.
34     exit(1);
35 }
36
37 /**
38  * Restore a backup of your own account from the browser
39  *
40  * @category  Account
41  * @package   StatusNet
42  * @author    Evan Prodromou <evan@status.net>
43  * @copyright 2010 StatusNet, Inc.
44  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
45  * @link      http://status.net/
46  */
47
48 class RestoreaccountAction extends Action
49 {
50     private $success = false;
51
52     /**
53      * Returns the title of the page
54      * 
55      * @return string page title
56      */
57
58     function title()
59     {
60         return _("Restore account");
61     }
62
63     /**
64      * For initializing members of the class.
65      *
66      * @param array $argarray misc. arguments
67      *
68      * @return boolean true
69      */
70
71     function prepare($argarray)
72     {
73         parent::prepare($argarray);
74
75         $cur = common_current_user();
76
77         if (empty($cur)) {
78             throw new ClientException(_('Only logged-in users can restore their account.'), 403);
79         }
80
81         if (!$cur->hasRight(Right::RESTOREACCOUNT)) {
82             throw new ClientException(_('You may not restore your account.'), 403);
83         }
84
85         return true;
86     }
87
88     /**
89      * Handler method
90      *
91      * @param array $argarray is ignored since it's now passed in in prepare()
92      *
93      * @return void
94      */
95
96     function handle($argarray=null)
97     {
98         parent::handle($argarray);
99
100         if ($this->isPost()) {
101             $this->restoreAccount();
102         } else {
103             $this->showPage();
104         }
105         return;
106     }
107
108     /**
109      * Queue a file for restoration
110      * 
111      * Uses the UserActivityStream class; may take a long time!
112      *
113      * @return void
114      */
115
116     function restoreAccount()
117     {
118         $this->checkSessionToken();
119
120         if (!isset($_FILES['restorefile']['error'])) {
121             throw new ClientException(_('No uploaded file.'));
122         }
123
124         switch ($_FILES['restorefile']['error']) {
125         case UPLOAD_ERR_OK: // success, jump out
126             break;
127         case UPLOAD_ERR_INI_SIZE:
128             // TRANS: Client exception thrown when an uploaded file is larger than set in php.ini.
129             throw new ClientException(_('The uploaded file exceeds the ' .
130                 'upload_max_filesize directive in php.ini.'));
131             return;
132         case UPLOAD_ERR_FORM_SIZE:
133             throw new ClientException(
134                 // TRANS: Client exception.
135                 _('The uploaded file exceeds the MAX_FILE_SIZE directive' .
136                 ' that was specified in the HTML form.'));
137             return;
138         case UPLOAD_ERR_PARTIAL:
139             @unlink($_FILES['restorefile']['tmp_name']);
140             // TRANS: Client exception.
141             throw new ClientException(_('The uploaded file was only' .
142                 ' partially uploaded.'));
143             return;
144         case UPLOAD_ERR_NO_FILE:
145             // No file; probably just a non-AJAX submission.
146             throw new ClientException(_('No uploaded file.'));
147             return;
148         case UPLOAD_ERR_NO_TMP_DIR:
149             // TRANS: Client exception thrown when a temporary folder is not present to store a file upload.
150             throw new ClientException(_('Missing a temporary folder.'));
151             return;
152         case UPLOAD_ERR_CANT_WRITE:
153             // TRANS: Client exception thrown when writing to disk is not possible during a file upload operation.
154             throw new ClientException(_('Failed to write file to disk.'));
155             return;
156         case UPLOAD_ERR_EXTENSION:
157             // TRANS: Client exception thrown when a file upload operation has been stopped by an extension.
158             throw new ClientException(_('File upload stopped by extension.'));
159             return;
160         default:
161             common_log(LOG_ERR, __METHOD__ . ": Unknown upload error " .
162                 $_FILES['restorefile']['error']);
163             // TRANS: Client exception thrown when a file upload operation has failed with an unknown reason.
164             throw new ClientException(_('System error uploading file.'));
165             return;
166         }
167
168         $filename = $_FILES['restorefile']['tmp_name'];
169
170         try {
171             if (!file_exists($filename)) {
172                 throw new ServerException("No such file '$filename'.");
173             }
174         
175             if (!is_file($filename)) {
176                 throw new ServerException("Not a regular file: '$filename'.");
177             }
178         
179             if (!is_readable($filename)) {
180                 throw new ServerException("File '$filename' not readable.");
181             }
182         
183             common_debug(sprintf(_("Getting backup from file '%s'."), $filename));
184
185             $xml = file_get_contents($filename);
186
187             // This check is costly but we should probably give
188             // the user some info ahead of time.
189             $doc = new DOMDocument();
190
191             // Disable PHP warnings so we don't spew low-level XML errors to output...
192             // would be nice if we can just get exceptions instead.
193             $old_err = error_reporting();
194             error_reporting($old_err & ~E_WARNING);
195             $doc->loadXML($xml);
196             error_reporting($old_err);
197
198             $feed = $doc->documentElement;
199
200             if (!$feed ||
201                 $feed->namespaceURI != Activity::ATOM ||
202                 $feed->localName != 'feed') {
203                 throw new ClientException(_("Not an atom feed."));
204             }
205
206             // Enqueue for processing.
207
208             $qm = QueueManager::get();
209             $qm->enqueue(array(common_current_user(), $xml, false), 'feedimp');
210
211             $this->success = true;
212             
213             $this->showPage();
214
215         } catch (Exception $e) {
216             // Delete the file and re-throw
217             @unlink($_FILES['restorefile']['tmp_name']);
218             throw $e;
219         }
220     }
221
222     /**
223      * Show a little form so that the person can upload a file to restore
224      *
225      * @return void
226      */
227     
228     function showContent()
229     {
230         if ($this->success) {
231             $this->element('p', null,
232                            _('Feed will be restored. Please wait a few minutes for results.'));
233         } else {
234             $form = new RestoreAccountForm($this);
235             $form->show();
236         }
237     }
238  
239     /**
240      * Return true if read only.
241      *
242      * MAY override
243      *
244      * @param array $args other arguments
245      *
246      * @return boolean is read only action?
247      */
248
249     function isReadOnly($args)
250     {
251         return false;
252     }
253
254     /**
255      * Return last modified, if applicable.
256      *
257      * MAY override
258      *
259      * @return string last modified http header
260      */
261
262     function lastModified()
263     {
264         // For comparison with If-Last-Modified
265         // If not applicable, return null
266         return null;
267     }
268
269     /**
270      * Return etag, if applicable.
271      *
272      * MAY override
273      *
274      * @return string etag http header
275      */
276
277     function etag()
278     {
279         return null;
280     }
281 }
282
283 /**
284  * A form for backing up the account.
285  *
286  * @category  Account
287  * @package   StatusNet
288  * @author    Evan Prodromou <evan@status.net>
289  * @copyright 2010 StatusNet, Inc.
290  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
291  * @link      http://status.net/
292  */
293
294 class RestoreAccountForm extends Form
295 {
296     function __construct($out=null) {
297         parent::__construct($out);
298         $this->enctype = 'multipart/form-data';
299     }
300
301     /**
302      * Class of the form.
303      *
304      * @return string the form's class
305      */
306
307     function formClass()
308     {
309         return 'form_profile_restore';
310     }
311
312     /**
313      * URL the form posts to
314      *
315      * @return string the form's action URL
316      */
317
318     function action()
319     {
320         return common_local_url('restoreaccount');
321     }
322
323     /**
324      * Output form data
325      * 
326      * Really, just instructions for doing a backup.
327      *
328      * @return void
329      */
330
331     function formData()
332     {
333         $this->out->elementStart('p', 'instructions');
334
335         $this->out->raw(_('You can upload a backed-up stream in '.
336                           '<a href="http://activitystrea.ms/">Activity Streams</a> format.'));
337         
338         $this->out->elementEnd('p');
339
340         $this->out->elementStart('ul', 'form_data');
341
342         $this->out->elementStart('li', array ('id' => 'settings_attach'));
343         $this->out->element('input', array('name' => 'restorefile',
344                                            'type' => 'file',
345                                            'id' => 'restorefile'));
346         $this->out->elementEnd('li');
347
348         $this->out->elementEnd('ul');
349     }
350
351     /**
352      * Buttons for the form
353      * 
354      * In this case, a single submit button
355      *
356      * @return void
357      */
358
359     function formActions()
360     {
361         $this->out->submit('submit',
362                            _m('BUTTON', 'Upload'),
363                            'submit',
364                            null,
365                            _('Upload the file'));
366     }
367 }