PHPackages                             consilience/laravel-storage-ls - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. consilience/laravel-storage-ls

ActiveLibrary[File & Storage](/categories/file-storage)

consilience/laravel-storage-ls
==============================

List the contents of Laravel file systems.

2.3.0(4mo ago)312.1k↓10.5%1MITPHPPHP ^8.2|^8.3|^8.4CI failing

Since Aug 21Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/consilience/laravel-storage-ls)[ Packagist](https://packagist.org/packages/consilience/laravel-storage-ls)[ RSS](/packages/consilience-laravel-storage-ls/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (3)Versions (17)Used By (0)

Laravel Storage ls
==================

[](#laravel-storage-ls)

List the files of Laravel file systems (aka disks) through a simple artisan command.

Laravel abstracts filesystems, both local and remote, using the [flysystem package](https://flysystem.thephpleague.com/docs/) and its adapters. The abstract unit on Laravel or Lumen for a filesystem is a *disk*, and each *disk* is configured in `config/filesystems.php`. This package provides an artisan command (`storage:ls`) to quickly and easily peek into a *disk*to see files and directories.

The command is read-only, so will not allow files or directories to be added, removed or modified. Any excpetions are left purposely unhandled, so it can aid diagnosing connection problems. There is no interaction expected, so the command can be used in an automated pipeline, and also in environments such as *vapor* that allow you to run artisan commands, but offer no interactive shell.

[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/6e996c4d9fb51d7db59d1e08c99e8a622a2f309fae5359babcd970de9dbb4324/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f6c61726176656c2d73746f726167652d6c732f646f776e6c6f6164733f666f726d61743d666c6174)](https://packagist.org/packages/consilience/laravel-storage-ls)[![Latest Stable Version](https://camo.githubusercontent.com/356c8b313a4530732ebeaa38bb794ff0f96b08b7c3141cd15f49f342fd508d44/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f6c61726176656c2d73746f726167652d6c732f762f737461626c65)](https://packagist.org/packages/consilience/laravel-storage-ls)[![Latest Unstable Version](https://camo.githubusercontent.com/cb4e7a484c4dd70096b16dcd11e6d8d85d7e248b4dc8f3df1953afacaa7b5998/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f6c61726176656c2d73746f726167652d6c732f762f756e737461626c653f666f726d61743d666c6174)](https://packagist.org/packages/consilience/laravel-storage-ls)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/519dbc77b639864cb1c09d5f872add92a7030ea6b3677328e25be37066c8d4f9/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f636f6e73696c69656e63652f6c61726176656c2d73746f726167652d6c732f6261646765732f7175616c6974792d73636f72652e706e673f666f726d61743d666c6174)](https://scrutinizer-ci.com/g/consilience/laravel-storage-ls)

Usage
=====

[](#usage)

List storage disks
------------------

[](#list-storage-disks)

```
$ php artisan storage:ls
```

This will return a list of the available disks with the default flagged \[\*\]:

```
Available disks:
+-----------+--------+
| name      | driver |
+-----------+--------+
| local [*] | local  |
| public    | local  |
| s3        | s3     |
+-----------+--------+

```

List files/directories in given disk
------------------------------------

[](#list-filesdirectories-in-given-disk)

```
$ php artisan storage:ls --disk=s3

# or

$ php artisan storage:ls -d s3

# or

$ php artisan storage:ls s3:
```

```
# Short format
$ php artisan storage:ls -d local
.gitignore
public

# Long format (directory flag, size bytes, date/time UTC, file or directory name)
$ php artisan storage:ls -d local -l
-         14 2019-03-05 14:27:03 .gitignore
d          0 2019-08-21 11:19:46 public
```

List files and directories in given directory
---------------------------------------------

[](#list-files-and-directories-in-given-directory)

```
$ php artisan storage:ls -d s3 my-folder/sub-folder

// or separate the disk and directory with a colon

$ php artisan storage:ls s3:my-folder/sub-folder
```

List files and directories recursively
--------------------------------------

[](#list-files-and-directories-recursively)

```
$ php artisan storage:ls -d local -R
/:
.gitignore
public

/public:
dirA
dirB
xyzFile

public/dirA:

public/dirB:
foobarFile
```

Similarly, in long format:

```
$ php artisan storage:ls -d local -Rl
/:
-         14 2019-03-05 14:27:03 .gitignore
d          0 2019-08-21 22:16:46 public

/public:
d          0 2019-08-21 22:16:43 dirB
d          0 2019-08-21 22:17:08 dirB
-          6 2019-08-21 21:54:54 xyzFile

public/dirA:

public/dirB:
-          5 2019-08-21 22:17:08 foobarFile
```

Installation
============

[](#installation)

Laravel and Lumen
-----------------

[](#laravel-and-lumen)

```
composer require consilience/laravel-storage-ls
```

There is no further configuration to do on Laravel.

### Lumen

[](#lumen)

Since Lumen does not do discovery on service providers, the provider needs to be manually registered in `bootstrap/app.php`:

```
$app->register(Consilience\Laravel\Ls\Providers\LsProvider::class);
```

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance84

Actively maintained with recent releases

Popularity29

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity85

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 86.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~182 days

Recently: every ~460 days

Total

14

Last Release

143d ago

Major Versions

1.2.2 → 2.0.02022-05-30

PHP version history (5 changes)1.0.3PHP ^7.0

1.2.0PHP ^7.3|^8

1.2.1PHP ^7.3|^8.0

2.0.0PHP ^8.0

2.3.0PHP ^8.2|^8.3|^8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/395934?v=4)[Jason Judge](/maintainers/judgej)[@judgej](https://github.com/judgej)

---

Top Contributors

[![judgej](https://avatars.githubusercontent.com/u/395934?v=4)](https://github.com/judgej "judgej (33 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (3 commits)")[![bradydan](https://avatars.githubusercontent.com/u/3979917?v=4)](https://github.com/bradydan "bradydan (1 commits)")[![Michael-Stokoe](https://avatars.githubusercontent.com/u/2981213?v=4)](https://github.com/Michael-Stokoe "Michael-Stokoe (1 commits)")

---

Tags

artisandiskflysystemlaravellumenstorage

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/consilience-laravel-storage-ls/health.svg)

```
[![Health](https://phpackages.com/badges/consilience-laravel-storage-ls/health.svg)](https://phpackages.com/packages/consilience-laravel-storage-ls)
```

###  Alternatives

[illuminate/filesystem

The Illuminate Filesystem package.

16165.1M3.2k](/packages/illuminate-filesystem)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)