PHPackages                             schnittstabil/finder-by-config - 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. schnittstabil/finder-by-config

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

schnittstabil/finder-by-config
==============================

Create Symfony\\Component\\Finder instances by configuration

1.1.0(8y ago)19244MITPHPPHP >=5.6.0

Since Apr 15Pushed 8y ago1 watchersCompare

[ Source](https://github.com/schnittstabil/finder-by-config)[ Packagist](https://packagist.org/packages/schnittstabil/finder-by-config)[ RSS](/packages/schnittstabil-finder-by-config/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (3)Versions (5)Used By (4)

FinderByConfig [![Build Status](https://camo.githubusercontent.com/d578d3d16a9934f07a68d552cf8148deab9e7111c1c414b2aea881830960c01e/68747470733a2f2f7472617669732d63692e6f72672f7363686e69747473746162696c2f66696e6465722d62792d636f6e6669672e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/schnittstabil/finder-by-config) [![Coverage Status](https://camo.githubusercontent.com/e75d88fc2e436a1fddd396f83ab7c06902fa44bbd7d6eac09e48f80ecba6b8ec/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f7363686e69747473746162696c2f66696e6465722d62792d636f6e6669672f62616467652e7376673f6272616e63683d6d617374657226736572766963653d676974687562)](https://coveralls.io/github/schnittstabil/finder-by-config?branch=master) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/a7044440b7cd050d51baa96feaf5feb762429d3150a6201fe84f56739aa6af9e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7363686e69747473746162696c2f66696e6465722d62792d636f6e6669672f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/schnittstabil/finder-by-config/?branch=master) [![Code Climate](https://camo.githubusercontent.com/c0f301bafca31c4b391454ad8edd70c7b2ed16bf6c442df5a46a9697fd1d02e0/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f7363686e69747473746162696c2f66696e6465722d62792d636f6e6669672f6261646765732f6770612e737667)](https://codeclimate.com/github/schnittstabil/finder-by-config)
======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#finderbyconfig----)

[![SensioLabsInsight](https://camo.githubusercontent.com/a78a80badc2f14cca2444719f304cfabe490da48aeec96af0cd253b128374466/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f32303161316435332d313161362d346231342d393530392d3863326632343866303964352f6269672e706e67)](https://insight.sensiolabs.com/projects/201a1d53-11a6-4b14-9509-8c2f248f09d5)

> Create Symfony\\Component\\Finder instances by configuration

Install
-------

[](#install)

```
$ composer require schnittstabil/finder-by-config

```

Usage
-----

[](#usage)

```
{
    ...
    "require": {
        "schnittstabil/finder-by-config": ...
    },
    "extra": {
        "you/your-package": {
            "simple": ["src", "tests", "composer.json"],
            "extended": {
                "in": ["."],
                "name": ["*.php", "*.json"],
                "notName": ["*Test.php"],
                "size": ["> 1K"],
                "exclude": ["build", "vendor"],
                "ignoreDotFiles": true,
                "ignoreVCS": true,
                "followLinks": false,
                "ignoreUnreadableDirs": false
            }
        }
    }
}
```

```
$config = json_decode(file_get_contents('composer.json'))->extra->{'you/your-package'};

$finder = \Schnittstabil\FinderByConfig\FinderByConfig::createFinder($config->simple);
$finder = \Schnittstabil\FinderByConfig\FinderByConfig::createFinder($config->extended);
```

Supported configuration options
-------------------------------

[](#supported-configuration-options)

For details see the [Finder Component Documentation](https://symfony.com/doc/current/components/finder.html).

OptionTypeDescription`directories``bool`directories only`files``bool`files only`depth``stringstring\[\]``date``stringstring\[\]``name``stringstring\[\]``notName``stringstring\[\]``contains``stringstring\[\]``notContains``stringstring\[\]``path``stringstring\[\]``notPath``stringstring\[\]``size``stringstring\[\]``exclude``stringstring\[\]``ignoreDotFiles``bool`exclude directories and files starting with a dot`ignoreVCS``bool`exclude version control directories`addVCSPattern``stringstring\[\]``sortByName``bool`sorts by name`sortByType``bool`sorts by type`sortByAccessedTime``bool`sorts by the last accessed time`sortByChangedTime``bool`sorts by the last inode changed time`sortByModifiedTime``bool`sorts by the last modified time`followLinks``bool`follow symlinks`ignoreUnreadableDirs``bool`ignore unreadable directories`in``stringstring\[\]`License
-------

[](#license)

MIT © [Michael Mayer](http://schnittstabil.de)

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity61

Established project with proven stability

 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 ~234 days

Total

4

Last Release

2977d ago

Major Versions

0.1.1 → 1.0.02017-02-14

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6059032?v=4)[Michael Mayer](/maintainers/schnittstabil)[@schnittstabil](https://github.com/schnittstabil)

---

Top Contributors

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

---

Tags

configfinder

### Embed Badge

![Health badge](/badges/schnittstabil-finder-by-config/health.svg)

```
[![Health](https://phpackages.com/badges/schnittstabil-finder-by-config/health.svg)](https://phpackages.com/packages/schnittstabil-finder-by-config)
```

###  Alternatives

[yosymfony/resource-watcher

A simple resource watcher using Symfony Finder

698.2M22](/packages/yosymfony-resource-watcher)[ergebnis/classy

Provides collectors for classy constructs (classes, enums, interfaces, and traits).

382.8M20](/packages/ergebnis-classy)[yii2mod/yii2-settings

Yii2 Settings Module

100167.4k11](/packages/yii2mod-yii2-settings)[arthurhoaro/favicon

PHP Library used to discover favicon from given URL

36737.4k](/packages/arthurhoaro-favicon)[edsdk/flmngr-server-php

Flmngr file manager PHP backend

20279.5k3](/packages/edsdk-flmngr-server-php)[samsonasik/array-lookup

A fast lookup library that help you verify and search array and Traversable data

2863.0k2](/packages/samsonasik-array-lookup)

PHPackages © 2026

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