3 * Stream outputter to send data to a file.
5 * Copyright © 2003, 2005, 2006 Brooke Vibber <bvibber@wikimedia.org>
6 * https://www.mediawiki.org/
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 * http://www.gnu.org/copyleft/gpl.html
29 class DumpFileOutput
extends DumpOutput
{
30 /** @var resource|false */
31 protected $handle = false;
38 public function __construct( $file ) {
39 $this->handle
= fopen( $file, "wt" );
40 $this->filename
= $file;
44 * @param string $string
46 public function writeCloseStream( $string ) {
47 parent
::writeCloseStream( $string );
48 if ( $this->handle
) {
49 fclose( $this->handle
);
50 $this->handle
= false;
55 * @param string $string
57 public function write( $string ) {
58 fputs( $this->handle
, $string );
64 public function closeRenameAndReopen( $newname ) {
65 $this->closeAndRename( $newname, true );
69 * @param string $newname
71 protected function renameOrException( $newname ) {
72 if ( !rename( $this->filename
, $newname ) ) {
73 throw new RuntimeException( __METHOD__
. ": rename of file {$this->filename} to $newname failed\n" );
78 * @param string|string[] $newname
82 protected function checkRenameArgCount( $newname ) {
83 if ( is_array( $newname ) ) {
84 if ( count( $newname ) > 1 ) {
85 throw new MWException( __METHOD__
. ": passed multiple arguments for rename of single file\n" );
87 $newname = $newname[0];
95 public function closeAndRename( $newname, $open = false ) {
96 $newname = $this->checkRenameArgCount( $newname );
98 if ( $this->handle
) {
99 fclose( $this->handle
);
100 $this->handle
= false;
102 $this->renameOrException( $newname );
104 $this->handle
= fopen( $this->filename
, "wt" );
110 * @return string|null
112 public function getFilenames() {
113 return $this->filename
;