VCardBuilder::checkSavePath() - Code Metrics - Inspection of "#98 php 7" - jeroendesloovere/vcard - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#105)

by Tom

created 2017-12-09 00:26 UTC

VCardBuilder::checkSavePath() A

↳ Parent: VCardBuilder

Complexity

Conditions	3
Paths	3

Size

Total Lines	13
Code Lines	6

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	13
rs	9.4285
c	0
b	0
f	0
cc	3
eloc	6
nc	3
nop	1

<?php

namespace JeroenDesloovere\VCard;

/*
 * This file is part of the VCard PHP Class from Jeroen Desloovere.
 *
 * For the full copyright and license information, please view the license
 * file that was distributed with this source code.
 */

use Behat\Transliterator\Transliterator;
use JeroenDesloovere\VCard\Exception\ElementAlreadyExistsException;
use JeroenDesloovere\VCard\Exception\OutputDirectoryNotExistsException;
use JeroenDesloovere\VCard\Model\VCard;
use JeroenDesloovere\VCard\Service\PropertyService;
use JeroenDesloovere\VCard\Util\GeneralUtil;
use JeroenDesloovere\VCard\Util\UserAgentUtil;

/**
 * VCard PHP Class to generate .vcard files and save them to a file or output as a download.
 */
class VCardBuilder
{
    /**
     * FileName
     *
     * @var string|null
     */
    private $fileName;

    /**
     * Properties
     *
     * @var array
     */
    private $properties;

    /**
     * Default Charset
     *
     * @var string
     */
    private $charset;

    /**
     * VCardBuilder constructor.
     *
     * @param VCard|VCard[] $vCard
     * @param string        $charset
     *
     * @throws ElementAlreadyExistsException
     */
    public function __construct($vCard, $charset = 'utf-8')
    {
        $this->charset = $charset;

        $propertyUtil = new PropertyService($vCard, $charset);

        $this->fileName = $propertyUtil->getFileName();
        $this->properties = $propertyUtil->getProperties();
    }

    /**
     * Build VCard (.vcf)
     *
     * @return string
     */
    public function buildVCard(): string
    {
        // init string
        $string = "BEGIN:VCARD\r\n";
        $string .= "VERSION:3.0\r\n";
        $string .= 'REV:'.date('Y-m-d').'T'.date('H:i:s')."Z\r\n";

        // loop all properties
        $properties = $this->getProperties();
        foreach ($properties as $property) {
            // add to string
            $string .= GeneralUtil::fold($property['key'].':'.GeneralUtil::escape($property['value'])."\r\n");
        }

        // add to string
        $string .= "END:VCARD\r\n";

        // return
        return $string;
    }

    /**
     * Build VCalender (.ics) - Safari (< iOS 8) can not open .vcf files, so we have build a workaround.
     *
     * @return string
     */
    public function buildVCalendar(): string
    {
        // init dates
        $dtbase = date('Ymd').'T'.date('Hi');
        $dtstart = $dtbase.'00';
        $dtend = $dtbase.'01';

        // init string
        $string = "BEGIN:VCALENDAR\n";
        $string .= "VERSION:2.0\n";
        $string .= "BEGIN:VEVENT\n";
        $string .= 'DTSTART;TZID=Europe/London:'.$dtstart."\n";
        $string .= 'DTEND;TZID=Europe/London:'.$dtend."\n";
        $string .= "SUMMARY:Click attached contact below to save to your contacts\n";
        $string .= 'DTSTAMP:'.$dtstart."Z\n";
        $string .= "ATTACH;VALUE=BINARY;ENCODING=BASE64;FMTTYPE=text/directory;\n";
        $string .= ' X-APPLE-FILENAME='.$this->getFullFileName().":\n";

        // base64 encode it so that it can be used as an attachment to the "dummy" calendar appointment
        $b64vcard = base64_encode($this->buildVCard());

        // chunk the single long line of b64 text in accordance with RFC2045
        // (and the exact line length determined from the original .ics file exported from Apple calendar
        $b64mline = chunk_split($b64vcard, 74, "\n");

        // need to indent all the lines by 1 space for the iphone (yes really?!!)
        $b64final = preg_replace('/(.+)/', ' $1', $b64mline);
        $string .= $b64final;

        // output the correctly formatted encoded text
        $string .= "END:VEVENT\n";
        $string .= "END:VCALENDAR\n";

        // return
        return $string;
    }

    /**
     * Download a vcard or vcal file to the browser.
     */
    public function download(): void
    {
        // define output
        $output = $this->getOutput();

        foreach ($this->getHeaders(false) as $header) {
            header($header);
        }

        // echo the output and it will be a download
        echo $output;
    }

    /**
     * Get charset
     *
     * @return string
     */
    public function getCharset(): string
    {
        return $this->charset;
    }

    /**
     * Get charset string
     *
     * @return string
     */
    public function getCharsetString(): string
    {
        $charsetString = '';

        if ($this->charset === 'utf-8') {
            $charsetString = ';CHARSET=UTF-8';
        }

        return $charsetString;
    }

    /**
     * Set filename
     *
     * @param string|array $value
     * @param bool         $overwrite [optional] Default overwrite is true
     * @param string       $separator [optional] Default separator is an underscore '_'
     * @return void
     */
    public function setFileName($value, $overwrite = true, $separator = '_'): void
    {
        // recast to string if $value is array
        if (\is_array($value)) {
            $value = implode($separator, $value);
        }

        // trim unneeded values
        $value = trim($value, $separator);

        // remove all spaces
        $value = preg_replace('/\s+/', $separator, $value);

        $pregQuoteSeparator = preg_quote($separator, '/');

        // if value is empty, stop here
        if (empty($value) || !preg_match("/[^\s$pregQuoteSeparator]/", $value)) {
            return;
        }

        // decode value
        $value = Transliterator::transliterate($value);

        // lowercase the string
        $value = strtolower($value);

        // urlize this part
        $value = Transliterator::urlize($value);

        // overwrite filename or add to filename using a prefix in between
        $this->fileName = $overwrite ?
            $value : $this->fileName.$separator.$value;
    }

    /**
     * Get filename
     *
     * @return string
     */
    public function getFileName(): string
    {
        if ($this->fileName === null) {
            return 'unknown';
        }

        return $this->fileName;
    }

    /**
     * Get content type
     *
     * @return string
     */
    public function getContentType(): string
    {
        return UserAgentUtil::isIOS7() ?
            'text/x-vcalendar' : 'text/x-vcard';
    }

    /**
     * Get file extension
     *
     * @return string
     */
    public function getFileExtension(): string
    {
        return UserAgentUtil::isIOS7() ?
            'ics' : 'vcf';
    }

    /**
     * Get full filename
     *
     * @return string
     */
    public function getFullFileName(): string
    {
        return $this->getFileName().'.'.$this->getFileExtension();
    }

    /**
     * Get headers
     *
     * @param bool $asAssociative
     * @return array
     */
    public function getHeaders(bool $asAssociative): array
    {
        $contentType = $this->getContentType().'; charset='.$this->getCharset();
        $contentDisposition = 'attachment; filename='.$this->getFullFileName();
        $contentLength = mb_strlen($this->getOutput(), $this->getCharset());
        $connection = 'close';

        if ($asAssociative) {
            return [
                'Content-type' => $contentType,
                'Content-Disposition' => $contentDisposition,
                'Content-Length' => $contentLength,
                'Connection' => $connection,
            ];
        }

        return [
            'Content-type: '.$contentType,
            'Content-Disposition: '.$contentDisposition,
            'Content-Length: '.$contentLength,
            'Connection: '.$connection,
        ];
    }

    /**
     * Get output as string
     * iOS devices (and safari < iOS 8 in particular) can not read .vcf (= vcard) files.
     * So I build a workaround to build a .ics (= vcalender) file.
     *
     * @return string
     */
    public function getOutput(): string
    {
        $output = UserAgentUtil::isIOS7() ?
            $this->buildVCalendar() : $this->buildVCard();

        return $output;
    }

    /**
     * Get properties
     *
     * @return array
     */
    public function getProperties(): array
    {
        return $this->properties;
    }

    /**
     * Has property
     *
     * @param string $key
     * @return bool
     */
    public function hasProperty(string $key): bool
    {
        $properties = $this->getProperties();

        foreach ($properties as $property) {
            if ($property['key'] === $key && $property['value'] !== '') {
                return true;
            }
        }

        return false;
    }

    /**
     * Save to a file
     *
     * @param string|null $savePath
     *
     * @return void
     * @throws OutputDirectoryNotExistsException
     */
    public function save(string $savePath = null): void
    {
        $file = $this->getFullFileName();

        // Add save path if given
        if (null !== $savePath) {
            $savePath = self::checkSavePath($savePath);

            $file = $savePath.$file;
        }

        file_put_contents(
            $file,
            $this->getOutput()
        );
    }

    /**
     * Check the save path directory
     *
     * @param string $savePath Save Path
     *
     * @return string
     * @throws OutputDirectoryNotExistsException
     */
    private static function checkSavePath($savePath): string
    {
        if (!is_dir($savePath)) {
            throw new OutputDirectoryNotExistsException();
        }

        // Add trailing directory separator the save path
        if (substr($savePath, -1) !== DIRECTORY_SEPARATOR) {
            $savePath .= DIRECTORY_SEPARATOR;
        }

        return $savePath;
    }
}


1			<?php
2
3			namespace JeroenDesloovere\VCard;
4
5			/*
6			* This file is part of the VCard PHP Class from Jeroen Desloovere.
7			*
8			* For the full copyright and license information, please view the license
9			* file that was distributed with this source code.
10			*/
11
12			use Behat\Transliterator\Transliterator;
13			use JeroenDesloovere\VCard\Exception\ElementAlreadyExistsException;
14			use JeroenDesloovere\VCard\Exception\OutputDirectoryNotExistsException;
15			use JeroenDesloovere\VCard\Model\VCard;
16			use JeroenDesloovere\VCard\Service\PropertyService;
17			use JeroenDesloovere\VCard\Util\GeneralUtil;
18			use JeroenDesloovere\VCard\Util\UserAgentUtil;
19
20			/**
21			* VCard PHP Class to generate .vcard files and save them to a file or output as a download.
22			*/
23			class VCardBuilder
24			{
25			/**
26			* FileName
27			*
28			* @var string\|null
29			*/
30			private $fileName;
31
32			/**
33			* Properties
34			*
35			* @var array
36			*/
37			private $properties;
38
39			/**
40			* Default Charset
41			*
42			* @var string
43			*/
44			private $charset;
45
46			/**
47			* VCardBuilder constructor.
48			*
49			* @param VCard\|VCard[] $vCard
50			* @param string $charset
51			*
52			* @throws ElementAlreadyExistsException
53			*/
54			public function __construct($vCard, $charset = 'utf-8')
55			{
56			$this->charset = $charset;
57
58			$propertyUtil = new PropertyService($vCard, $charset);
59
60			$this->fileName = $propertyUtil->getFileName();
61			$this->properties = $propertyUtil->getProperties();
62			}
63
64			/**
65			* Build VCard (.vcf)
66			*
67			* @return string
68			*/
69			public function buildVCard(): string
70			{
71			// init string
72			$string = "BEGIN:VCARD\r\n";
73			$string .= "VERSION:3.0\r\n";
74			$string .= 'REV:'.date('Y-m-d').'T'.date('H:i:s')."Z\r\n";
75
76			// loop all properties
77			$properties = $this->getProperties();
78			foreach ($properties as $property) {
79			// add to string
80			$string .= GeneralUtil::fold($property['key'].':'.GeneralUtil::escape($property['value'])."\r\n");
81			}
82
83			// add to string
84			$string .= "END:VCARD\r\n";
85
86			// return
87			return $string;
88			}
89
90			/**
91			* Build VCalender (.ics) - Safari (< iOS 8) can not open .vcf files, so we have build a workaround.
92			*
93			* @return string
94			*/
95			public function buildVCalendar(): string
96			{
97			// init dates
98			$dtbase = date('Ymd').'T'.date('Hi');
99			$dtstart = $dtbase.'00';
100			$dtend = $dtbase.'01';
101
102			// init string
103			$string = "BEGIN:VCALENDAR\n";
104			$string .= "VERSION:2.0\n";
105			$string .= "BEGIN:VEVENT\n";
106			$string .= 'DTSTART;TZID=Europe/London:'.$dtstart."\n";
107			$string .= 'DTEND;TZID=Europe/London:'.$dtend."\n";
108			$string .= "SUMMARY:Click attached contact below to save to your contacts\n";
109			$string .= 'DTSTAMP:'.$dtstart."Z\n";
110			$string .= "ATTACH;VALUE=BINARY;ENCODING=BASE64;FMTTYPE=text/directory;\n";
111			$string .= ' X-APPLE-FILENAME='.$this->getFullFileName().":\n";
112
113			// base64 encode it so that it can be used as an attachment to the "dummy" calendar appointment
114			$b64vcard = base64_encode($this->buildVCard());
115
116			// chunk the single long line of b64 text in accordance with RFC2045
117			// (and the exact line length determined from the original .ics file exported from Apple calendar
118			$b64mline = chunk_split($b64vcard, 74, "\n");
119
120			// need to indent all the lines by 1 space for the iphone (yes really?!!)
121			$b64final = preg_replace('/(.+)/', ' $1', $b64mline);
122			$string .= $b64final;
123
124			// output the correctly formatted encoded text
125			$string .= "END:VEVENT\n";
126			$string .= "END:VCALENDAR\n";
127
128			// return
129			return $string;
130			}
131
132			/**
133			* Download a vcard or vcal file to the browser.
134			*/
135			public function download(): void
136			{
137			// define output
138			$output = $this->getOutput();
139
140			foreach ($this->getHeaders(false) as $header) {
141			header($header);
142			}
143
144			// echo the output and it will be a download
145			echo $output;
146			}
147
148			/**
149			* Get charset
150			*
151			* @return string
152			*/
153			public function getCharset(): string
154			{
155			return $this->charset;
156			}
157
158			/**
159			* Get charset string
160			*
161			* @return string
162			*/
163			public function getCharsetString(): string
164			{
165			$charsetString = '';
166
167			if ($this->charset === 'utf-8') {
168			$charsetString = ';CHARSET=UTF-8';
169			}
170
171			return $charsetString;
172			}
173
174			/**
175			* Set filename
176			*
177			* @param string\|array $value
178			* @param bool $overwrite [optional] Default overwrite is true
179			* @param string $separator [optional] Default separator is an underscore '_'
180			* @return void
181			*/
182			public function setFileName($value, $overwrite = true, $separator = '_'): void
183			{
184			// recast to string if $value is array
185			if (\is_array($value)) {
186			$value = implode($separator, $value);
187			}
188
189			// trim unneeded values
190			$value = trim($value, $separator);
191
192			// remove all spaces
193			$value = preg_replace('/\s+/', $separator, $value);
194
195			$pregQuoteSeparator = preg_quote($separator, '/');
196
197			// if value is empty, stop here
198			if (empty($value) \|\| !preg_match("/[^\s$pregQuoteSeparator]/", $value)) {
199			return;
200			}
201
202			// decode value
203			$value = Transliterator::transliterate($value);
204
205			// lowercase the string
206			$value = strtolower($value);
207
208			// urlize this part
209			$value = Transliterator::urlize($value);
210
211			// overwrite filename or add to filename using a prefix in between
212			$this->fileName = $overwrite ?
213			$value : $this->fileName.$separator.$value;
214			}
215
216			/**
217			* Get filename
218			*
219			* @return string
220			*/
221			public function getFileName(): string
222			{
223			if ($this->fileName === null) {
224			return 'unknown';
225			}
226
227			return $this->fileName;
228			}
229
230			/**
231			* Get content type
232			*
233			* @return string
234			*/
235			public function getContentType(): string
236			{
237			return UserAgentUtil::isIOS7() ?
238			'text/x-vcalendar' : 'text/x-vcard';
239			}
240
241			/**
242			* Get file extension
243			*
244			* @return string
245			*/
246			public function getFileExtension(): string
247			{
248			return UserAgentUtil::isIOS7() ?
249			'ics' : 'vcf';
250			}
251
252			/**
253			* Get full filename
254			*
255			* @return string
256			*/
257			public function getFullFileName(): string
258			{
259			return $this->getFileName().'.'.$this->getFileExtension();
260			}
261
262			/**
263			* Get headers
264			*
265			* @param bool $asAssociative
266			* @return array
267			*/
268			public function getHeaders(bool $asAssociative): array
269			{
270			$contentType = $this->getContentType().'; charset='.$this->getCharset();
271			$contentDisposition = 'attachment; filename='.$this->getFullFileName();
272			$contentLength = mb_strlen($this->getOutput(), $this->getCharset());
273			$connection = 'close';
274
275			if ($asAssociative) {
276			return [
277			'Content-type' => $contentType,
278			'Content-Disposition' => $contentDisposition,
279			'Content-Length' => $contentLength,
280			'Connection' => $connection,
281			];
282			}
283
284			return [
285			'Content-type: '.$contentType,
286			'Content-Disposition: '.$contentDisposition,
287			'Content-Length: '.$contentLength,
288			'Connection: '.$connection,
289			];
290			}
291
292			/**
293			* Get output as string
294			* iOS devices (and safari < iOS 8 in particular) can not read .vcf (= vcard) files.
295			* So I build a workaround to build a .ics (= vcalender) file.
296			*
297			* @return string
298			*/
299			public function getOutput(): string
300			{
301			$output = UserAgentUtil::isIOS7() ?
302			$this->buildVCalendar() : $this->buildVCard();
303
304			return $output;
305			}
306
307			/**
308			* Get properties
309			*
310			* @return array
311			*/
312			public function getProperties(): array
313			{
314			return $this->properties;
315			}
316
317			/**
318			* Has property
319			*
320			* @param string $key
321			* @return bool
322			*/
323			public function hasProperty(string $key): bool
324			{
325			$properties = $this->getProperties();
326
327			foreach ($properties as $property) {
328			if ($property['key'] === $key && $property['value'] !== '') {
329			return true;
330			}
331			}
332
333			return false;
334			}
335
336			/**
337			* Save to a file
338			*
339			* @param string\|null $savePath
340			*
341			* @return void
342			* @throws OutputDirectoryNotExistsException
343			*/
344			public function save(string $savePath = null): void
345			{
346			$file = $this->getFullFileName();
347
348			// Add save path if given
349			if (null !== $savePath) {
350			$savePath = self::checkSavePath($savePath);
351
352			$file = $savePath.$file;
353			}
354
355			file_put_contents(
356			$file,
357			$this->getOutput()
358			);
359			}
360
361			/**
362			* Check the save path directory
363			*
364			* @param string $savePath Save Path
365			*
366			* @return string
367			* @throws OutputDirectoryNotExistsException
368			*/
369			private static function checkSavePath($savePath): string
370			{
371			if (!is_dir($savePath)) {
372			throw new OutputDirectoryNotExistsException();
373			}
374
375			// Add trailing directory separator the save path
376			if (substr($savePath, -1) !== DIRECTORY_SEPARATOR) {
377			$savePath .= DIRECTORY_SEPARATOR;
378			}
379
380			return $savePath;
381			}
382			}
383

jeroendesloovere / vcard

Pull Request — master (#105)

VCardBuilder::checkSavePath() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like