1<?php
  2/**
  3 * WordPress FTP Filesystem.
  4 *
  5 * @package WordPress
  6 * @subpackage Filesystem
  7 */
  8
  9/**
 10 * WordPress Filesystem Class for implementing FTP.
 11 *
 12 * @since 2.5.0
 13 *
 14 * @see WP_Filesystem_Base
 15 */
 16class WP_Filesystem_FTPext extends WP_Filesystem_Base {
 17
 18	/**
 19	 * @since 2.5.0
 20	 * @var FTP\Connection|resource|false
 21	 */
 22	public $link;
 23
 24	/**
 25	 * Constructor.
 26	 *
 27	 * @since 2.5.0
 28	 *
 29	 * @param array $opt
 30	 */
 31	public function __construct( $opt = '' ) {
 32		$this->method = 'ftpext';
 33		$this->errors = new WP_Error();
 34
 35		// Check if possible to use ftp functions.
 36		if ( ! extension_loaded( 'ftp' ) ) {
 37			$this->errors->add( 'no_ftp_ext', __( 'The ftp PHP extension is not available' ) );
 38			return;
 39		}
 40
 41		// This class uses the timeout on a per-connection basis, others use it on a per-action basis.
 42		if ( ! defined( 'FS_TIMEOUT' ) ) {
 43			define( 'FS_TIMEOUT', 4 * MINUTE_IN_SECONDS );
 44		}
 45
 46		if ( empty( $opt['port'] ) ) {
 47			$this->options['port'] = 21;
 48		} else {
 49			$this->options['port'] = $opt['port'];
 50		}
 51
 52		if ( empty( $opt['hostname'] ) ) {
 53			$this->errors->add( 'empty_hostname', __( 'FTP hostname is required' ) );
 54		} else {
 55			$this->options['hostname'] = $opt['hostname'];
 56		}
 57
 58		// Check if the options provided are OK.
 59		if ( empty( $opt['username'] ) ) {
 60			$this->errors->add( 'empty_username', __( 'FTP username is required' ) );
 61		} else {
 62			$this->options['username'] = $opt['username'];
 63		}
 64
 65		if ( empty( $opt['password'] ) ) {
 66			$this->errors->add( 'empty_password', __( 'FTP password is required' ) );
 67		} else {
 68			$this->options['password'] = $opt['password'];
 69		}
 70
 71		$this->options['ssl'] = false;
 72
 73		if ( isset( $opt['connection_type'] ) && 'ftps' === $opt['connection_type'] ) {
 74			$this->options['ssl'] = true;
 75		}
 76	}
 77
 78	/**
 79	 * Connects filesystem.
 80	 *
 81	 * @since 2.5.0
 82	 *
 83	 * @return bool True on success, false on failure.
 84	 */
 85	public function connect() {
 86		if ( isset( $this->options['ssl'] ) && $this->options['ssl'] && function_exists( 'ftp_ssl_connect' ) ) {
 87			$this->link = @ftp_ssl_connect( $this->options['hostname'], $this->options['port'], FS_CONNECT_TIMEOUT );
 88		} else {
 89			$this->link = @ftp_connect( $this->options['hostname'], $this->options['port'], FS_CONNECT_TIMEOUT );
 90		}
 91
 92		if ( ! $this->link ) {
 93			$this->errors->add(
 94				'connect',
 95				sprintf(
 96					/* translators: %s: hostname:port */
 97					__( 'Failed to connect to FTP Server %s' ),
 98					$this->options['hostname'] . ':' . $this->options['port']
 99				)
100			);
101
102			return false;
103		}
104
105		if ( ! @ftp_login( $this->link, $this->options['username'], $this->options['password'] ) ) {
106			$this->errors->add(
107				'auth',
108				sprintf(
109					/* translators: %s: Username. */
110					__( 'Username/Password incorrect for %s' ),
111					$this->options['username']
112				)
113			);
114
115			return false;
116		}
117
118		// Set the connection to use Passive FTP.
119		ftp_pasv( $this->link, true );
120
121		if ( @ftp_get_option( $this->link, FTP_TIMEOUT_SEC ) < FS_TIMEOUT ) {
122			@ftp_set_option( $this->link, FTP_TIMEOUT_SEC, FS_TIMEOUT );
123		}
124
125		return true;
126	}
127
128	/**
129	 * Reads entire file into a string.
130	 *
131	 * @since 2.5.0
132	 *
133	 * @param string $file Name of the file to read.
134	 * @return string|false Read data on success, false if no temporary file could be opened,
135	 *                      or if the file couldn't be retrieved.
136	 */
137	public function get_contents( $file ) {
138		$tempfile   = wp_tempnam( $file );
139		$temphandle = fopen( $tempfile, 'w+' );
140
141		if ( ! $temphandle ) {
142			unlink( $tempfile );
143			return false;
144		}
145
146		if ( ! ftp_fget( $this->link, $temphandle, $file, FTP_BINARY ) ) {
147			fclose( $temphandle );
148			unlink( $tempfile );
149			return false;
150		}
151
152		fseek( $temphandle, 0 ); // Skip back to the start of the file being written to.
153		$contents = '';
154
155		while ( ! feof( $temphandle ) ) {
156			$contents .= fread( $temphandle, 8 * KB_IN_BYTES );
157		}
158
159		fclose( $temphandle );
160		unlink( $tempfile );
161
162		return $contents;
163	}
164
165	/**
166	 * Reads entire file into an array.
167	 *
168	 * @since 2.5.0
169	 *
170	 * @param string $file Path to the file.
171	 * @return array|false File contents in an array on success, false on failure.
172	 */
173	public function get_contents_array( $file ) {
174		return explode( "\n", $this->get_contents( $file ) );
175	}
176
177	/**
178	 * Writes a string to a file.
179	 *
180	 * @since 2.5.0
181	 *
182	 * @param string    $file     Remote path to the file where to write the data.
183	 * @param string    $contents The data to write.
184	 * @param int|false $mode     Optional. The file permissions as octal number, usually 0644.
185	 *                            Default false.
186	 * @return bool True on success, false on failure.
187	 */
188	public function put_contents( $file, $contents, $mode = false ) {
189		$tempfile   = wp_tempnam( $file );
190		$temphandle = fopen( $tempfile, 'wb+' );
191
192		if ( ! $temphandle ) {
193			unlink( $tempfile );
194			return false;
195		}
196
197		mbstring_binary_safe_encoding();
198
199		$data_length   = strlen( $contents );
200		$bytes_written = fwrite( $temphandle, $contents );
201
202		reset_mbstring_encoding();
203
204		if ( $data_length !== $bytes_written ) {
205			fclose( $temphandle );
206			unlink( $tempfile );
207			return false;
208		}
209
210		fseek( $temphandle, 0 ); // Skip back to the start of the file being written to.
211
212		$ret = ftp_fput( $this->link, $file, $temphandle, FTP_BINARY );
213
214		fclose( $temphandle );
215		unlink( $tempfile );
216
217		$this->chmod( $file, $mode );
218
219		return $ret;
220	}
221
222	/**
223	 * Gets the current working directory.
224	 *
225	 * @since 2.5.0
226	 *
227	 * @return string|false The current working directory on success, false on failure.
228	 */
229	public function cwd() {
230		$cwd = ftp_pwd( $this->link );
231
232		if ( $cwd ) {
233			$cwd = trailingslashit( $cwd );
234		}
235
236		return $cwd;
237	}
238
239	/**
240	 * Changes current directory.
241	 *
242	 * @since 2.5.0
243	 *
244	 * @param string $dir The new current directory.
245	 * @return bool True on success, false on failure.
246	 */
247	public function chdir( $dir ) {
248		return @ftp_chdir( $this->link, $dir );
249	}
250
251	/**
252	 * Changes filesystem permissions.
253	 *
254	 * @since 2.5.0
255	 *
256	 * @param string    $file      Path to the file.
257	 * @param int|false $mode      Optional. The permissions as octal number, usually 0644 for files,
258	 *                             0755 for directories. Default false.
259	 * @param bool      $recursive Optional. If set to true, changes file permissions recursively.
260	 *                             Default false.
261	 * @return bool True on success, false on failure.
262	 */
263	public function chmod( $file, $mode = false, $recursive = false ) {
264		if ( ! $mode ) {
265			if ( $this->is_file( $file ) ) {
266				$mode = FS_CHMOD_FILE;
267			} elseif ( $this->is_dir( $file ) ) {
268				$mode = FS_CHMOD_DIR;
269			} else {
270				return false;
271			}
272		}
273
274		// chmod any sub-objects if recursive.
275		if ( $recursive && $this->is_dir( $file ) ) {
276			$filelist = $this->dirlist( $file );
277
278			foreach ( (array) $filelist as $filename => $filemeta ) {
279				$this->chmod( $file . '/' . $filename, $mode, $recursive );
280			}
281		}
282
283		// chmod the file or directory.
284		if ( ! function_exists( 'ftp_chmod' ) ) {
285			return (bool) ftp_site( $this->link, sprintf( 'CHMOD %o %s', $mode, $file ) );
286		}
287
288		return (bool) ftp_chmod( $this->link, $mode, $file );
289	}
290
291	/**
292	 * Gets the file owner.
293	 *
294	 * @since 2.5.0
295	 *
296	 * @param string $file Path to the file.
297	 * @return string|false Username of the owner on success, false on failure.
298	 */
299	public function owner( $file ) {
300		$dir = $this->dirlist( $file );
301
302		return $dir[ $file ]['owner'];
303	}
304
305	/**
306	 * Gets the permissions of the specified file or filepath in their octal format.
307	 *
308	 * @since 2.5.0
309	 *
310	 * @param string $file Path to the file.
311	 * @return string Mode of the file (the last 3 digits).
312	 */
313	public function getchmod( $file ) {
314		$dir = $this->dirlist( $file );
315
316		return $dir[ $file ]['permsn'];
317	}
318
319	/**
320	 * Gets the file's group.
321	 *
322	 * @since 2.5.0
323	 *
324	 * @param string $file Path to the file.
325	 * @return string|false The group on success, false on failure.
326	 */
327	public function group( $file ) {
328		$dir = $this->dirlist( $file );
329
330		return $dir[ $file ]['group'];
331	}
332
333	/**
334	 * Copies a file.
335	 *
336	 * @since 2.5.0
337	 *
338	 * @param string    $source      Path to the source file.
339	 * @param string    $destination Path to the destination file.
340	 * @param bool      $overwrite   Optional. Whether to overwrite the destination file if it exists.
341	 *                               Default false.
342	 * @param int|false $mode        Optional. The permissions as octal number, usually 0644 for files,
343	 *                               0755 for dirs. Default false.
344	 * @return bool True on success, false on failure.
345	 */
346	public function copy( $source, $destination, $overwrite = false, $mode = false ) {
347		if ( ! $overwrite && $this->exists( $destination ) ) {
348			return false;
349		}
350
351		$content = $this->get_contents( $source );
352
353		if ( false === $content ) {
354			return false;
355		}
356
357		return $this->put_contents( $destination, $content, $mode );
358	}
359
360	/**
361	 * Moves a file or directory.
362	 *
363	 * After moving files or directories, OPcache will need to be invalidated.
364	 *
365	 * If moving a directory fails, `copy_dir()` can be used for a recursive copy.
366	 *
367	 * Use `move_dir()` for moving directories with OPcache invalidation and a
368	 * fallback to `copy_dir()`.
369	 *
370	 * @since 2.5.0
371	 *
372	 * @param string $source      Path to the source file or directory.
373	 * @param string $destination Path to the destination file or directory.
374	 * @param bool   $overwrite   Optional. Whether to overwrite the destination if it exists.
375	 *                            Default false.
376	 * @return bool True on success, false on failure.
377	 */
378	public function move( $source, $destination, $overwrite = false ) {
379		return ftp_rename( $this->link, $source, $destination );
380	}
381
382	/**
383	 * Deletes a file or directory.
384	 *
385	 * @since 2.5.0
386	 *
387	 * @param string       $file      Path to the file or directory.
388	 * @param bool         $recursive Optional. If set to true, deletes files and folders recursively.
389	 *                                Default false.
390	 * @param string|false $type      Type of resource. 'f' for file, 'd' for directory.
391	 *                                Default false.
392	 * @return bool True on success, false on failure.
393	 */
394	public function delete( $file, $recursive = false, $type = false ) {
395		if ( empty( $file ) ) {
396			return false;
397		}
398
399		if ( 'f' === $type || $this->is_file( $file ) ) {
400			return ftp_delete( $this->link, $file );
401		}
402
403		if ( ! $recursive ) {
404			return ftp_rmdir( $this->link, $file );
405		}
406
407		$filelist = $this->dirlist( trailingslashit( $file ) );
408
409		if ( ! empty( $filelist ) ) {
410			foreach ( $filelist as $delete_file ) {
411				$this->delete( trailingslashit( $file ) . $delete_file['name'], $recursive, $delete_file['type'] );
412			}
413		}
414
415		return ftp_rmdir( $this->link, $file );
416	}
417
418	/**
419	 * Checks if a file or directory exists.
420	 *
421	 * @since 2.5.0
422	 * @since 6.3.0 Returns false for an empty path.
423	 *
424	 * @param string $path Path to file or directory.
425	 * @return bool Whether $path exists or not.
426	 */
427	public function exists( $path ) {
428		/*
429		 * Check for empty path. If ftp_nlist() receives an empty path,
430		 * it checks the current working directory and may return true.
431		 *
432		 * See https://core.trac.wordpress.org/ticket/33058.
433		 */
434		if ( '' === $path ) {
435			return false;
436		}
437
438		$list = ftp_nlist( $this->link, $path );
439
440		if ( empty( $list ) && $this->is_dir( $path ) ) {
441			return true; // File is an empty directory.
442		}
443
444		return ! empty( $list ); // Empty list = no file, so invert.
445	}
446
447	/**
448	 * Checks if resource is a file.
449	 *
450	 * @since 2.5.0
451	 *
452	 * @param string $file File path.
453	 * @return bool Whether $file is a file.
454	 */
455	public function is_file( $file ) {
456		return $this->exists( $file ) && ! $this->is_dir( $file );
457	}
458
459	/**
460	 * Checks if resource is a directory.
461	 *
462	 * @since 2.5.0
463	 *
464	 * @param string $path Directory path.
465	 * @return bool Whether $path is a directory.
466	 */
467	public function is_dir( $path ) {
468		$cwd    = $this->cwd();
469		$result = @ftp_chdir( $this->link, trailingslashit( $path ) );
470
471		if ( $result && $path === $this->cwd() || $this->cwd() !== $cwd ) {
472			@ftp_chdir( $this->link, $cwd );
473			return true;
474		}
475
476		return false;
477	}
478
479	/**
480	 * Checks if a file is readable.
481	 *
482	 * @since 2.5.0
483	 *
484	 * @param string $file Path to file.
485	 * @return bool Whether $file is readable.
486	 */
487	public function is_readable( $file ) {
488		return true;
489	}
490
491	/**
492	 * Checks if a file or directory is writable.
493	 *
494	 * @since 2.5.0
495	 *
496	 * @param string $path Path to file or directory.
497	 * @return bool Whether $path is writable.
498	 */
499	public function is_writable( $path ) {
500		return true;
501	}
502
503	/**
504	 * Gets the file's last access time.
505	 *
506	 * @since 2.5.0
507	 *
508	 * @param string $file Path to file.
509	 * @return int|false Unix timestamp representing last access time, false on failure.
510	 */
511	public function atime( $file ) {
512		return false;
513	}
514
515	/**
516	 * Gets the file modification time.
517	 *
518	 * @since 2.5.0
519	 *
520	 * @param string $file Path to file.
521	 * @return int|false Unix timestamp representing modification time, false on failure.
522	 */
523	public function mtime( $file ) {
524		return ftp_mdtm( $this->link, $file );
525	}
526
527	/**
528	 * Gets the file size (in bytes).
529	 *
530	 * @since 2.5.0
531	 *
532	 * @param string $file Path to file.
533	 * @return int|false Size of the file in bytes on success, false on failure.
534	 */
535	public function size( $file ) {
536		$size = ftp_size( $this->link, $file );
537
538		return ( $size > -1 ) ? $size : false;
539	}
540
541	/**
542	 * Sets the access and modification times of a file.
543	 *
544	 * Note: If $file doesn't exist, it will be created.
545	 *
546	 * @since 2.5.0
547	 *
548	 * @param string $file  Path to file.
549	 * @param int    $time  Optional. Modified time to set for file.
550	 *                      Default 0.
551	 * @param int    $atime Optional. Access time to set for file.
552	 *                      Default 0.
553	 * @return bool True on success, false on failure.
554	 */
555	public function touch( $file, $time = 0, $atime = 0 ) {
556		return false;
557	}
558
559	/**
560	 * Creates a directory.
561	 *
562	 * @since 2.5.0
563	 *
564	 * @param string           $path  Path for new directory.
565	 * @param int|false        $chmod Optional. The permissions as octal number (or false to skip chmod).
566	 *                                Default false.
567	 * @param string|int|false $chown Optional. A user name or number (or false to skip chown).
568	 *                                Default false.
569	 * @param string|int|false $chgrp Optional. A group name or number (or false to skip chgrp).
570	 *                                Default false.
571	 * @return bool True on success, false on failure.
572	 */
573	public function mkdir( $path, $chmod = false, $chown = false, $chgrp = false ) {
574		$path = untrailingslashit( $path );
575
576		if ( empty( $path ) ) {
577			return false;
578		}
579
580		if ( ! ftp_mkdir( $this->link, $path ) ) {
581			return false;
582		}
583
584		$this->chmod( $path, $chmod );
585
586		return true;
587	}
588
589	/**
590	 * Deletes a directory.
591	 *
592	 * @since 2.5.0
593	 *
594	 * @param string $path      Path to directory.
595	 * @param bool   $recursive Optional. Whether to recursively remove files/directories.
596	 *                          Default false.
597	 * @return bool True on success, false on failure.
598	 */
599	public function rmdir( $path, $recursive = false ) {
600		return $this->delete( $path, $recursive );
601	}
602
603	/**
604	 * Parses an individual entry from the FTP LIST command output.
605	 *
606	 * @param string $line A line from the directory listing.
607	 * @return array|string {
608	 *     Array of file information. Empty string if the line could not be parsed.
609	 *
610	 *     @type string       $name        Name of the file or directory.
611	 *     @type string       $perms       *nix representation of permissions.
612	 *     @type string       $permsn      Octal representation of permissions.
613	 *     @type string|false $number      File number as a string, or false if not available.
614	 *     @type string|false $owner       Owner name or ID, or false if not available.
615	 *     @type string|false $group       File permissions group, or false if not available.
616	 *     @type string|false $size        Size of file in bytes as a string, or false if not available.
617	 *     @type string|false $lastmodunix Last modified unix timestamp as a string, or false if not available.
618	 *     @type string|false $lastmod     Last modified month (3 letters) and day (without leading 0), or
619	 *                                     false if not available.
620	 *     @type string|false $time        Last modified time, or false if not available.
621	 *     @type string       $type        Type of resource. 'f' for file, 'd' for directory, 'l' for link.
622	 *     @type array|false  $files       If a directory and `$recursive` is true, contains another array of files.
623	 *                                     False if unable to list directory contents.
624	 * }
625	 */
626	public function parselisting( $line ) {
627		static $is_windows = null;
628
629		if ( is_null( $is_windows ) ) {
630			$is_windows = stripos( ftp_systype( $this->link ), 'win' ) !== false;
631		}
632
633		if ( $is_windows && preg_match( '/([0-9]{2})-([0-9]{2})-([0-9]{2}) +([0-9]{2}):([0-9]{2})(AM|PM) +([0-9]+|<DIR>) +(.+)/', $line, $lucifer ) ) {
634			$b = array();
635
636			if ( $lucifer[3] < 70 ) {
637				$lucifer[3] += 2000;
638			} else {
639				$lucifer[3] += 1900; // 4-digit year fix.
640			}
641
642			$b['isdir'] = ( '<DIR>' === $lucifer[7] );
643
644			if ( $b['isdir'] ) {
645				$b['type'] = 'd';
646			} else {
647				$b['type'] = 'f';
648			}
649
650			$b['size']   = $lucifer[7];
651			$b['month']  = $lucifer[1];
652			$b['day']    = $lucifer[2];
653			$b['year']   = $lucifer[3];
654			$b['hour']   = $lucifer[4];
655			$b['minute'] = $lucifer[5];
656			$b['time']   = mktime( $lucifer[4] + ( strcasecmp( $lucifer[6], 'PM' ) === 0 ? 12 : 0 ), $lucifer[5], 0, $lucifer[1], $lucifer[2], $lucifer[3] );
657			$b['am/pm']  = $lucifer[6];
658			$b['name']   = $lucifer[8];
659		} elseif ( ! $is_windows ) {
660			$lucifer = preg_split( '/[ ]/', $line, 9, PREG_SPLIT_NO_EMPTY );
661
662			if ( $lucifer ) {
663				$lcount = count( $lucifer );
664
665				if ( $lcount < 8 ) {
666					return '';
667				}
668
669				$b           = array();
670				$b['isdir']  = 'd' === $lucifer[0][0];
671				$b['islink'] = 'l' === $lucifer[0][0];
672
673				if ( $b['isdir'] ) {
674					$b['type'] = 'd';
675				} elseif ( $b['islink'] ) {
676					$b['type'] = 'l';
677				} else {
678					$b['type'] = 'f';
679				}
680
681				$b['perms']  = $lucifer[0];
682				$b['permsn'] = $this->getnumchmodfromh( $b['perms'] );
683				$b['number'] = $lucifer[1];
684				$b['owner']  = $lucifer[2];
685				$b['group']  = $lucifer[3];
686				$b['size']   = $lucifer[4];
687
688				if ( 8 === $lcount ) {
689					sscanf( $lucifer[5], '%d-%d-%d', $b['year'], $b['month'], $b['day'] );
690					sscanf( $lucifer[6], '%d:%d', $b['hour'], $b['minute'] );
691
692					$b['time'] = mktime( $b['hour'], $b['minute'], 0, $b['month'], $b['day'], $b['year'] );
693					$b['name'] = $lucifer[7];
694				} else {
695					$b['month'] = $lucifer[5];
696					$b['day']   = $lucifer[6];
697
698					if ( preg_match( '/([0-9]{2}):([0-9]{2})/', $lucifer[7], $l2 ) ) {
699						$b['year']   = gmdate( 'Y' );
700						$b['hour']   = $l2[1];
701						$b['minute'] = $l2[2];
702					} else {
703						$b['year']   = $lucifer[7];
704						$b['hour']   = 0;
705						$b['minute'] = 0;
706					}
707
708					$b['time'] = strtotime( sprintf( '%d %s %d %02d:%02d', $b['day'], $b['month'], $b['year'], $b['hour'], $b['minute'] ) );
709					$b['name'] = $lucifer[8];
710				}
711			}
712		}
713
714		// Replace symlinks formatted as "source -> target" with just the source name.
715		if ( isset( $b['islink'] ) && $b['islink'] ) {
716			$b['name'] = preg_replace( '/(\s*->\s*.*)$/', '', $b['name'] );
717		}
718
719		return $b;
720	}
721
722	/**
723	 * Gets details for files in a directory or a specific file.
724	 *
725	 * @since 2.5.0
726	 *
727	 * @param string $path           Path to directory or file.
728	 * @param bool   $include_hidden Optional. Whether to include details of hidden ("." prefixed) files.
729	 *                               Default true.
730	 * @param bool   $recursive      Optional. Whether to recursively include file details in nested directories.
731	 *                               Default false.
732	 * @return array|false {
733	 *     Array of arrays containing file information. False if unable to list directory contents.
734	 *
735	 *     @type array ...$0 {
736	 *         Array of file information. Note that some elements may not be available on all filesystems.
737	 *
738	 *         @type string           $name        Name of the file or directory.
739	 *         @type string           $perms       *nix representation of permissions.
740	 *         @type string           $permsn      Octal representation of permissions.
741	 *         @type int|string|false $number      File number. May be a numeric string. False if not available.
742	 *         @type string|false     $owner       Owner name or ID, or false if not available.
743	 *         @type string|false     $group       File permissions group, or false if not available.
744	 *         @type int|string|false $size        Size of file in bytes. May be a numeric string.
745	 *                                             False if not available.
746	 *         @type int|string|false $lastmodunix Last modified unix timestamp. May be a numeric string.
747	 *                                             False if not available.
748	 *         @type string|false     $lastmod     Last modified month (3 letters) and day (without leading 0), or
749	 *                                             false if not available.
750	 *         @type string|false     $time        Last modified time, or false if not available.
751	 *         @type string           $type        Type of resource. 'f' for file, 'd' for directory, 'l' for link.
752	 *         @type array|false      $files       If a directory and `$recursive` is true, contains another array of
753	 *                                             files. False if unable to list directory contents.
754	 *     }
755	 * }
756	 */
757	public function dirlist( $path = '.', $include_hidden = true, $recursive = false ) {
758		if ( $this->is_file( $path ) ) {
759			$limit_file = basename( $path );
760			$path       = dirname( $path ) . '/';
761		} else {
762			$limit_file = false;
763		}
764
765		$pwd = ftp_pwd( $this->link );
766
767		if ( ! @ftp_chdir( $this->link, $path ) ) { // Can't change to folder = folder doesn't exist.
768			return false;
769		}
770
771		$list = ftp_rawlist( $this->link, '-a', false );
772
773		@ftp_chdir( $this->link, $pwd );
774
775		if ( empty( $list ) ) { // Empty array = non-existent folder (real folder will show . at least).
776			return false;
777		}
778
779		$dirlist = array();
780
781		foreach ( $list as $k => $v ) {
782			$entry = $this->parselisting( $v );
783
784			if ( empty( $entry ) ) {
785				continue;
786			}
787
788			if ( '.' === $entry['name'] || '..' === $entry['name'] ) {
789				continue;
790			}
791
792			if ( ! $include_hidden && '.' === $entry['name'][0] ) {
793				continue;
794			}
795
796			if ( $limit_file && $entry['name'] !== $limit_file ) {
797				continue;
798			}
799
800			$dirlist[ $entry['name'] ] = $entry;
801		}
802
803		$path = trailingslashit( $path );
804		$ret  = array();
805
806		foreach ( (array) $dirlist as $struc ) {
807			if ( 'd' === $struc['type'] ) {
808				if ( $recursive ) {
809					$struc['files'] = $this->dirlist( $path . $struc['name'], $include_hidden, $recursive );
810				} else {
811					$struc['files'] = array();
812				}
813			}
814
815			$ret[ $struc['name'] ] = $struc;
816		}
817
818		return $ret;
819	}
820
821	/**
822	 * Destructor.
823	 *
824	 * @since 2.5.0
825	 */
826	public function __destruct() {
827		if ( $this->link ) {
828			ftp_close( $this->link );
829		}
830	}
831}
832