PHPackages                             cline/globby - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. cline/globby

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

cline/globby
============

User-friendly glob matching for PHP with negation patterns, directory expansion, and gitignore support

2.0.3(2mo ago)00MITPHPPHP ^8.5.0CI passing

Since Mar 4Pushed 2mo agoCompare

[ Source](https://github.com/faustbrian/globby)[ Packagist](https://packagist.org/packages/cline/globby)[ RSS](/packages/cline-globby/feed)WikiDiscussions 2.x Synced 1mo ago

READMEChangelog (1)Dependencies (14)Versions (9)Used By (0)

[![GitHub Workflow Status](https://github.com/faustbrian/globby/actions/workflows/quality-assurance.yaml/badge.svg)](https://github.com/faustbrian/globby/actions)[![Latest Version on Packagist](https://camo.githubusercontent.com/2a77c650456ec681d00baaa944831bb4480b3bb873de2f06c3f040186840ed52/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c696e652f676c6f6262792e737667)](https://packagist.org/packages/cline/globby)[![Software License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/285fbdb387361477573cc645e1e4aca14d9360030ed8d6c1de9be6ed0d3142e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c696e652f676c6f6262792e737667)](https://packagist.org/packages/cline/globby)

---

Globby
======

[](#globby)

A user-friendly glob matching library for PHP, inspired by [sindresorhus/globby](https://github.com/sindresorhus/globby). Features multiple pattern support, negation patterns, gitignore integration, and a fluent configuration API.

Requirements
------------

[](#requirements)

> **Requires [PHP 8.4+](https://php.net/releases/)**

Installation
------------

[](#installation)

```
composer require cline/globby
```

Documentation
-------------

[](#documentation)

- **[Basic Usage](DOCS.md#doc-cookbooks-basic-usage)** - Pattern matching fundamentals, multiple patterns, negation, and streaming
- **[Filtering Options](DOCS.md#doc-cookbooks-filtering-options)** - Files vs directories, dotfiles, depth limiting, and path formatting
- **[Gitignore Integration](DOCS.md#doc-cookbooks-gitignore-integration)** - Respecting .gitignore rules and custom ignore files
- **[Advanced Patterns](DOCS.md#doc-cookbooks-advanced-patterns)** - Brace expansion, character classes, globstar, and escaping

Supported Options
-----------------

[](#supported-options)

OptionTypeDefaultDescription`cwd``string``getcwd()`Current working directory`expandDirectories``bool|array``true`Auto-expand directories to glob contents`gitignore``bool``false`Respect .gitignore rules`ignoreFiles``string|array``null`Custom ignore file patterns`ignore``array``[]`Additional patterns to ignore`onlyFiles``bool``true`Match only files`onlyDirectories``bool``false`Match only directories`dot``bool``false`Include dotfiles`deep``int``null`Maximum traversal depth`followSymbolicLinks``bool``true`Follow symbolic links`suppressErrors``bool``false`Suppress file system errors`absolute``bool``false`Return absolute paths`unique``bool``true`Deduplicate results`markDirectories``bool``false`Add trailing slash to directories`caseSensitiveMatch``bool``true`Case-sensitive pattern matching`baseNameMatch``bool``false`Match patterns against basename only`throwErrorOnBrokenSymbolicLink``bool``false`Throw error on broken symlinks`objectMode``bool``false`Return GlobEntry objects instead of strings`stats``bool``false`Include file statistics (implies objectMode)`fs``FileSystemAdapter``null`Custom file system adapterChange log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please use the [GitHub security reporting form](https://github.com/faustbrian/globby/security) rather than the issue queue.

Credits
-------

[](#credits)

- [Brian Faust](https://github.com/faustbrian)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License. Please see [License File](LICENSE.md) for more information.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance88

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~15 days

Recently: every ~3 days

Total

8

Last Release

61d ago

Major Versions

1.0.2 → 2.0.02026-03-04

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/22145591?v=4)[Brian Faust](/maintainers/faustbrian)[@faustbrian](https://github.com/faustbrian)

---

Top Contributors

[![faustbrian](https://avatars.githubusercontent.com/u/22145591?v=4)](https://github.com/faustbrian "faustbrian (11 commits)")

---

Tags

phplaravelfilesglobpatternmatchinggitignoredirectories

### Embed Badge

![Health badge](/badges/cline-globby/health.svg)

```
[![Health](https://phpackages.com/badges/cline-globby/health.svg)](https://phpackages.com/packages/cline-globby)
```

###  Alternatives

[spatie/laravel-livewire-wizard

Build wizards using Livewire

4061.0M4](/packages/spatie-laravel-livewire-wizard)[nativephp/mobile

NativePHP for Mobile

82724.0k43](/packages/nativephp-mobile)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[laragear/preload

Effortlessly make a Preload script for your Laravel application.

119363.5k](/packages/laragear-preload)[tapp/filament-google-autocomplete-field

Filament plugin that provides a Google Autocomplete field

3098.1k](/packages/tapp-filament-google-autocomplete-field)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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