PHPackages phuxtil/find - 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. phuxtil/find ActiveLibrary phuxtil/find ============ Easy interface for output of 'find' unix command 3.0.0(4y ago)014.8k↓100%[1 PRs](https://github.com/oliwierptak/phuxtil-find/pulls)2MITPHPPHP ^8CI passing Since Jun 16Pushed 3mo agoCompare [ Source](https://github.com/oliwierptak/phuxtil-find)[ Packagist](https://packagist.org/packages/phuxtil/find)[ RSS](/packages/phuxtil-find/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (4)Versions (7)Used By (2) phuxtil-find ============ [](#phuxtil-find) Easy interface for output of `find` unix command > In Unix-like and some other operating systems, find is a command-line utility that searches one or more directory trees of a file system, locates files based on some user-specified criteria and applies a user-specified action on each matched file. ### Installation [](#installation) ``` composer require phuxtil/find ``` *Note*: Use v1.x for compatibility with PHP v7.0.x *Note*: Use v2.x for compatibility with PHP v7.2+ ### Usage [](#usage) ###### find sample output [](#find-sample-output) ``` 1560682188|1560682181|1560682181|0755|root|root|0|0|d|10245134|0|160|5|remote_fs/|/tmp/remote_fs/ 1560682162|1560682181|1560682181|0644|root|root|0|0|f|10269956|8|1210|1|test.txt|/tmp/remote_fs/test.txt 1560682162|1560682181|1560682181|0644|root|root|0|0|f|10269956|8|1210|1|test_link.txt|/tmp/remote_fs/test_link.txt ``` ##### Configuration [](#configuration) Use `Phuxtil\Find\FindConfigurator` for configuration options. ``` $configurator = (new FindConfigurator()) ->setFormat('%As|%Cs|%Ts|%#m|%u|%g|%U|%G|%y|%i|%b|%s|%n|%f|%p') ->setFormatDelimiter('|') ->setLineDelimiter("\n") ->setFindOutput(...); ``` ##### Facade [](#facade) ``` $results = (new FindFacade())->process($configurator); ``` ``` [ 0 => Phuxtil\SplFileInfo\VirtualSplFileInfo { path: "/tmp" filename: "remote_fs" basename: "remote_fs" pathname: "/tmp/remote_fs" extension: "" realPath: "/tmp/remote_fs" aTime: 2019-06-16 12:49:48 mTime: 2019-06-16 12:49:41 cTime: 2019-06-16 12:49:41 inode: "10245134" size: "160" perms: 0755 owner: "0" group: "0" type: "dir" writable: true readable: true executable: true file: false dir: true link: false linkTarget: -1 } 1 => Phuxtil\SplFileInfo\VirtualSplFileInfo { path: "/tmp/remote_fs" filename: "test.txt" basename: "test.txt" pathname: "/tmp/remote_fs/test.txt" extension: "txt" realPath: "/tmp/remote_fs/test.txt" aTime: 2019-06-16 12:49:22 mTime: 2019-06-16 12:49:41 cTime: 2019-06-16 12:49:41 inode: "10269956" size: "1210" perms: 0644 owner: "0" group: "0" type: "file" writable: true readable: true executable: false file: true dir: false link: false linkTarget: -1 } 2 => Phuxtil\SplFileInfo\VirtualSplFileInfo { path: "/tmp/remote_fs" filename: "test_link.txt" basename: "test_link.txt" pathname: "/tmp/remote_fs/test_link.txt" extension: "txt" realPath: "/tmp/remote_fs/test_link.txt" aTime: 2019-06-16 12:49:22 mTime: 2019-06-16 12:49:41 cTime: 2019-06-16 12:49:41 inode: "10269956" size: "1210" perms: 0644 owner: "0" group: "0" type: "file" writable: true readable: true executable: false file: true dir: false link: false linkTarget: -1 } ] ``` The result is an array containing `VirtualSplFileInfo` objects which are compatible with `\SplFileInfo`. ``` echo $results[0]->getPathname(); # /tmp/remote_fs echo $results[1]->isReadable(); # true echo $results[2]->getSize(); # 1210 ``` #### TDD [](#tdd) See [`tests`](https://github.com/oliwierptak/phuxtil-find/blob/master/tests/Functional/Find/FindFacadeTest.php) for details. ### Health Score 41 — FairBetter than 88% of packages Maintenance57 Moderate activity, may be stable Popularity22 Limited adoption so far Community8 Small or concentrated contributor base Maturity63 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 1816d ago Major Versions 1.0.1 → 2.0.02020-02-05 2.0.0 → 3.0.02021-05-18 PHP version history (3 changes)1.0.0PHP ^7 2.0.0PHP ^7.2 3.0.0PHP ^8 ### Community Maintainers ![](https://www.gravatar.com/avatar/73a4cc056d2b09189dda46d01b76e71161dd9b75a226230bed6bec8f414d1cf8?d=identicon)[oliwierptak](/maintainers/oliwierptak) --- Top Contributors [![oliwierptak](https://avatars.githubusercontent.com/u/495101?v=4)](https://github.com/oliwierptak "oliwierptak (21 commits)") --- Tags findformatoutputphpshellunix ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/phuxtil-find/health.svg) ``` [![Health](https://phpackages.com/badges/phuxtil-find/health.svg)](https://phpackages.com/packages/phuxtil-find) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)