1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
<?php
/**
* League.csv - A lightweight CSV Coder/Decoder library
*
* @author Ignace Nyamagana Butera <nyamsprod@gmail.com>
* @copyright 2014 Ignace Nyamagana Butera
* @link https://github.com/nyamsprod/League.csv
* @license http://opensource.org/licenses/MIT
* @version 5.0.0
* @package League.csv
*
* MIT LICENSE
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sublicense, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace League\Csv;
use InvalidArgumentException;
use Traversable;
/**
* A class to manage data insertion into a CSV
*
* @package League.csv
* @since 4.0.0
*
*/
class Writer extends AbstractCsv
{
/**
* {@inheritdoc}
*/
public function __construct($path, $open_mode = 'w')
{
parent::__construct($path, $open_mode);
}
/**
* Add a new CSV row to the generated CSV
*
* @param mixed $row a string, an array or an object implementing to '__toString' method
*
* @return self
*
* @throws InvalidArgumentException If the given row format is invalid
*/
public function insertOne($row)
{
if (self::isValidString($row)) {
$row = str_getcsv((string) $row, $this->delimiter, $this->enclosure, $this->escape);
}
if (! is_array($row)) {
throw new InvalidArgumentException(
'the row provided must be an array of a valid string that can be converted into an array'
);
}
$check = array_filter($row, function ($value) {
return self::isValidString($value);
});
if (count($check) == count($row)) {
$this->csv->fputcsv($row, $this->delimiter, $this->enclosure);
return $this;
}
throw new InvalidArgumentException(
'the provided data can not be transform into a single CSV data row'
);
}
/**
* Add multiple lines to the CSV your are generating
*
* @param mixed $rows a multidimentional array or a Traversable object
*
* @return self
*
* @throws \InvalidArgumentException If the given rows format is invalid
*/
public function insertAll($rows)
{
if (! is_array($rows) && ! $rows instanceof Traversable) {
throw new InvalidArgumentException(
'the provided data must be an array OR a \Traversable object'
);
}
foreach ($rows as $row) {
$this->insertOne($row);
}
return $this;
}
/**
* Instantiate a {@link Reader} class from the current {@link Writer}
*
* @return \League\Csv\Reader
*/
public function getReader()
{
$csv = new Reader($this->csv);
$csv->setDelimiter($this->delimiter);
$csv->setEnclosure($this->enclosure);
$csv->setEscape($this->escape);
$csv->setFlags($this->flags);
$csv->setEncoding($this->encoding);
return $csv;
}
}
|
