Completed
Pull Request — master (#81)
by
unknown
02:06
created

DbDumper::useCompression()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 6

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
dl 0
loc 6
rs 10
c 0
b 0
f 0
cc 1
nc 1
nop 1
1
<?php
2
3
namespace Spatie\DbDumper;
4
5
use Symfony\Component\Process\Process;
6
use Spatie\DbDumper\Exceptions\DumpFailed;
7
use Spatie\DbDumper\Compressors\Compression;
8
use Spatie\DbDumper\Compressors\GzipCompression;
9
use Spatie\DbDumper\Exceptions\CannotSetParameter;
10
11
abstract class DbDumper
12
{
13
    /** @var string */
14
    protected $dbName;
15
16
    /** @var string */
17
    protected $userName;
18
19
    /** @var string */
20
    protected $password;
21
22
    /** @var string */
23
    protected $host = 'localhost';
24
25
    /** @var int */
26
    protected $port = 5432;
27
28
    /** @var string */
29
    protected $socket = '';
30
31
    /** @var int */
32
    protected $timeout = 0;
33
34
    /** @var string */
35
    protected $dumpBinaryPath = '';
36
37
    /** @var array */
38
    protected $includeTables = [];
39
40
    /** @var array */
41
    protected $excludeTables = [];
42
43
    /** @var array */
44
    protected $extraOptions = [];
45
46
    /** @var string */
47
    protected $compression = null;
48
49
    public static function create()
50
    {
51
        return new static();
52
    }
53
54
    public function getDbName(): string
55
    {
56
        return $this->dbName;
57
    }
58
59
    /**
60
     * @param string $dbName
61
     *
62
     * @return $this
63
     */
64
    public function setDbName(string $dbName)
65
    {
66
        $this->dbName = $dbName;
67
68
        return $this;
69
    }
70
71
    /**
72
     * @param string $userName
73
     *
74
     * @return $this
75
     */
76
    public function setUserName(string $userName)
77
    {
78
        $this->userName = $userName;
79
80
        return $this;
81
    }
82
83
    /**
84
     * @param string $password
85
     *
86
     * @return $this
87
     */
88
    public function setPassword(string $password)
89
    {
90
        $this->password = $password;
91
92
        return $this;
93
    }
94
95
    /**
96
     * @param string $host
97
     *
98
     * @return $this
99
     */
100
    public function setHost(string $host)
101
    {
102
        $this->host = $host;
103
104
        return $this;
105
    }
106
107
    public function getHost(): string
108
    {
109
        return $this->host;
110
    }
111
112
    /**
113
     * @param int $port
114
     *
115
     * @return $this
116
     */
117
    public function setPort(int $port)
118
    {
119
        $this->port = $port;
120
121
        return $this;
122
    }
123
124
    /**
125
     * @param string $socket
126
     *
127
     * @return $this
128
     */
129
    public function setSocket(string $socket)
130
    {
131
        $this->socket = $socket;
132
133
        return $this;
134
    }
135
136
    /**
137
     * @param int $timeout
138
     *
139
     * @return $this
140
     */
141
    public function setTimeout(int $timeout)
142
    {
143
        $this->timeout = $timeout;
144
145
        return $this;
146
    }
147
148
    /**
149
     * @param string $dumpBinaryPath
150
     *
151
     * @return $this
152
     */
153
    public function setDumpBinaryPath(string $dumpBinaryPath)
154
    {
155
        if ($dumpBinaryPath !== '' && substr($dumpBinaryPath, -1) !== '/') {
156
            $dumpBinaryPath .= '/';
157
        }
158
159
        $this->dumpBinaryPath = $dumpBinaryPath;
160
161
        return $this;
162
    }
163
164
    /**
165
     * @return $this
166
     */
167
    public function enableCompression()
168
    {
169
        $this->compression = new GzipCompression;
0 ignored issues
show
Documentation Bug introduced by
It seems like new \Spatie\DbDumper\Compressors\GzipCompression() of type object<Spatie\DbDumper\C...essors\GzipCompression> is incompatible with the declared type string of property $compression.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
170
171
        return $this;
172
    }
173
174
    /**
175
     * @return $tring
0 ignored issues
show
Documentation introduced by
The doc-type $tring could not be parsed: Unknown type name "$tring" at position 0. (view supported doc-types)

This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types.

Loading history...
176
     */
177
    public function getCompressionExtension()
178
    {
179
        return $this->compression->getExtension();
0 ignored issues
show
Bug introduced by
The method getExtension cannot be called on $this->compression (of type string).

Methods can only be called on objects. This check looks for methods being called on variables that have been inferred to never be objects.

Loading history...
180
    }
181
182
    /**
183
     * Set the given compression.
184
     *
185
     * @param Compression $compression
186
     *
187
     * @return $this
188
     */
189
    public function useCompression(Compression $compression)
190
    {
191
        $this->compression = $compression;
0 ignored issues
show
Documentation Bug introduced by
It seems like $compression of type object<Spatie\DbDumper\Compressors\Compression> is incompatible with the declared type string of property $compression.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
192
193
        return $this;
194
    }
195
196
    /**
197
     * @param string|array $includeTables
198
     *
199
     * @return $this
200
     *
201
     * @throws \Spatie\DbDumper\Exceptions\CannotSetParameter
202
     */
203 View Code Duplication
    public function includeTables($includeTables)
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
204
    {
205
        if (! empty($this->excludeTables)) {
206
            throw CannotSetParameter::conflictingParameters('includeTables', 'excludeTables');
207
        }
208
209
        if (! is_array($includeTables)) {
210
            $includeTables = explode(', ', $includeTables);
211
        }
212
213
        $this->includeTables = $includeTables;
214
215
        return $this;
216
    }
217
218
    /**
219
     * @param string|array $excludeTables
220
     *
221
     * @return $this
222
     *
223
     * @throws \Spatie\DbDumper\Exceptions\CannotSetParameter
224
     */
225 View Code Duplication
    public function excludeTables($excludeTables)
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
226
    {
227
        if (! empty($this->includeTables)) {
228
            throw CannotSetParameter::conflictingParameters('excludeTables', 'includeTables');
229
        }
230
231
        if (! is_array($excludeTables)) {
232
            $excludeTables = explode(', ', $excludeTables);
233
        }
234
235
        $this->excludeTables = $excludeTables;
236
237
        return $this;
238
    }
239
240
    /**
241
     * @param string $extraOption
242
     *
243
     * @return $this
244
     */
245
    public function addExtraOption(string $extraOption)
246
    {
247
        if (! empty($extraOption)) {
248
            $this->extraOptions[] = $extraOption;
249
        }
250
251
        return $this;
252
    }
253
254
    abstract public function dumpToFile(string $dumpFile);
255
256
    protected function checkIfDumpWasSuccessFul(Process $process, string $outputFile)
257
    {
258
        if (! $process->isSuccessful()) {
259
            throw DumpFailed::processDidNotEndSuccessfully($process);
260
        }
261
262
        if (! file_exists($outputFile)) {
263
            throw DumpFailed::dumpfileWasNotCreated();
264
        }
265
266
        if (filesize($outputFile) === 0) {
267
            throw DumpFailed::dumpfileWasEmpty();
268
        }
269
    }
270
271
    protected function echoToFile(string $command, string $dumpFile): string
272
    {
273
        $compression = $this->compression ? ' | '.$this->compression->getCommand() : '';
0 ignored issues
show
Bug introduced by
The method getCommand cannot be called on $this->compression (of type string).

Methods can only be called on objects. This check looks for methods being called on variables that have been inferred to never be objects.

Loading history...
274
        $dumpFile = '"'.addcslashes($dumpFile, '\\"').'"';
275
276
        return $command.$compression.' > '.$dumpFile;
277
    }
278
}
279